Breeze Chms MCP Server

MCP运维云端

提供方 JoshTheDerf

运维云端 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

一个提供Breeze教会管理系统API访问的服务器,支持人员管理、活动管理、捐款记录、标签管理等功能,适用于教堂管理场景。

一句话选型结论

按资料字段整理

Breeze Chms MCP Server 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 30 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量30暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

教会管理JavaScript本地部署人员管理活动管理捐款记录标签管理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 30 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 30 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Breeze Chms MCP Server当前 30 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方JoshTheDerf上游标注的维护方 JoshTheDerf
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.7 KB
来自项目仓库与上游目录的原文,未做删改

Breeze ChMS MCP服务器

模型上下文协议(MCP)服务器,提供对微风教堂管理系统API的访问。该服务器允许AI助手与Breeze ChMS数据进行交互,包括人员管理、事件、贡献、标签、表格、志愿者和家庭。

特性

人员管理

  • 列出具有筛选选项的人员
  • 获取详细的人员信息
  • 添加新用户
  • 更新人员信息
  • 删除人员
  • 管理配置文件字段

事件管理

  • 列出日期范围内的事件
  • 获取活动详细信息和时间表
  • 创建新事件
  • 删除事件实例
  • 管理活动日历
  • 处理活动出席和登记

标签和组织

  • 列出所有标签和标签文件夹
  • 创建新标签和文件夹
  • 为人员分配/取消分配标签
  • 使用标签层次结构进行组织

表单

  • 列表表格(活动和存档)
  • 获取表单字段定义
  • 检索表单条目
  • 删除表单条目

志愿者

  • 列出活动志愿者
  • 安排/不安排志愿者
  • 管理志愿者角色

家

  • 创建新家庭
  • 添加/删除家庭成员
  • 摧毁现有家庭

捐款/捐赠

  • 添加贡献记录
  • 支持多种支付方式
  • 处理资金分配
  • 批量捐款

活动日志

  • 查看详细的活动日志
  • 按操作类型、日期、用户筛选
  • 轨道系统变更

安装

  1. 克隆此存储库

  2. 安装依赖项:```bash
    npm install


1. 构建项目:```bash
npm run build

配置

设置以下环境变量:

  • BREEZE_SUBDOMAIN:您的Breeze子域名(例如,mychurch.breezechms.com的“mychurch”)
  • BREEZE_API_KEY:您的Breeze API密钥(可从Breeze中的扩展>API页面获得)

获取API密钥

  1. 登录您的Breeze ChMS帐户
  2. 首选 扩展 > API
  3. 复制API密钥
  4. 从浏览器URL中注意您的子域

用法

运行服务器```bash

Development mode

npm run dev

Production mode

npm run build && npm start


### MCP客户端配置

将此服务器添加到MCP客户端配置中:```json
{
"mcpServers": {
"breeze-chms": {
"command": "node",
"args": ["path/to/breeze-chms-mcp-server/dist/index.js"],
"env": {
"BREEZE_SUBDOMAIN": "your-church-subdomain",
"BREEZE_API_KEY": "your-api-key-here"
}
}
}
}

Claude桌面配置

对于Claude Desktop,请在配置文件中添加:```json
{
"mcpServers": {
"breeze-chms": {
"command": "npx",
"args": ["breeze-chms-mcp-server"],
"env": {
"BREEZE_SUBDOMAIN": "your-church-subdomain",
"BREEZE_API_KEY": "your-api-key-here"
}
}
}
}


## 可用工具

### 人员管理

- `list_people` -列出具有可选过滤和分页功能的人员
- `get_person` -获取特定人员的详细信息
- `add_person` -将新用户添加到数据库
- `update_person` -更新现有人员信息
- `delete_person` -从数据库中删除人员
- `list_profile_fields` -获取所有配置文件字段部分和定义

### 标签管理

- `list_tags` -列出所有标签和标签文件夹
- `add_tag` -创建新标签
- `add_tag_folder` -创建新的标签文件夹
- `assign_tag` -为某人分配标签
- `unassign_tag` -从某人身上删除标签

### 事件管理

- `list_events` -列出日期范围内的事件
- `get_event` -获取特定事件实例的详细信息
- `add_event` -创建新事件
- `delete_event_instance` -删除特定事件实例
- `list_calendars` -列出所有活动日历

### 活动出席情况

- `checkin_person` -检查一个人是否参加活动
- `get_event_attendance` -获取活动的出席记录

### 表单

- `list_forms` -列出所有表格(活动或存档)
- `list_form_fields` -列出特定表单的字段
- `list_form_entries` -列出特定表单的条目

### 志愿者

- `list_volunteers` -列出活动实例的志愿者
- `schedule_volunteer` -为活动安排志愿者
- `unschedule_volunteer` -从活动中删除志愿者

### 家

- `create_family` -与指定人员创建新家庭
- `destroy_family` -摧毁一个现有的家庭
- `add_to_family` -将人添加到现有家庭
- `remove_from_family` -将人们从当前家庭中删除

### 捐赠/贡献

- `add_contribution` -添加捐款/捐赠记录

### 活动日志

- `list_activity` -列出带有筛选选项的活动日志条目

## 示例用法

### 列出人员```javascript
// List first 50 people with basic info
{
"tool": "list_people",
"arguments": {
"details": 0,
"limit": 50
}
}

// List people with full details and filtering
{
"tool": "list_people",
"arguments": {
"details": 1,
"filter_json": "{\"tag_contains\": \"volunteer\"}"
}
}

添加新用户```javascript

{
"tool": "add_person",
"arguments": {
"first": "John",
"last": "Doe",
"fields_json": "[{\"field_id\":\"email_primary\",\"field_type\":\"email\",\"response\":true,\"details\":{\"address\":\"john.doe@example.com\"}}]"
}
}


### 让某人参与活动```javascript
{
"tool": "checkin_person",
"arguments": {
"person_id": "12345678",
"instance_id": "98765432",
"direction": "in"
}
}

添加贡献```javascript

{
"tool": "add_contribution",
"arguments": {
"date": "2024-01-15",
"person_json": "{\"name\":\"Jane Smith\",\"email\":\"jane@example.com\"}",
"method": "Check",
"amount": 100.00,
"funds_json": "[{\"name\":\"General Fund\",\"amount\":75},{\"name\":\"Missions Fund\",\"amount\":25}]"
}
}


### 分配标签```javascript
{
"tool": "assign_tag",
"arguments": {
"person_id": "12345678",
"tag_id": "567890"
}
}

API费率限制

微风API的速率限制为 每分钟20个请求。服务器将自动处理此问题,但为了获得最佳性能,请考虑:

  • 间隔API调用(请求之间等待约3.5秒)
  • 尽可能使用批量操作
  • 对频繁访问的数据实施缓存

错误处理

服务器为常见问题提供详细的错误消息:

  • API凭据无效
  • 缺少必要参数
  • API请求频率超限
  • 无效的人员/事件/标签ID
  • 网络连接问题

字段类型和结构

在更新人员或使用自定义字段时,您需要了解Breeze的字段结构:

常见字段类型

  • text -简单的文本输入
  • textarea -多行文本
  • radio -多选/下拉菜单(使用选项ID)
  • checkbox -多项选择
  • date -日期字段
  • email -电子邮件地址
  • phone -电话号码
  • address -街道地址
  • birthdate -出生日期
  • family_role -家庭关系角色

字段JSON结构```javascript

// Text field
{
"field_id": "123456789",
"field_type": "text",
"response": "Sample text value"
}

// Email field
{
"field_id": "987654321",
"field_type": "email",
"response": true,
"details": {
"address": "user@example.com"
}
}

// Phone field
{
"field_id": "456789123",
"field_type": "phone",
"response": true,
"details": {
"phone_mobile": "555-123-4567"
}
}


## 故障排除

### 常见问题

1. **身份验证错误**

- 验证您的API密钥是否正确
- 检查您的子域是否与您的Breeze URL匹配
- 确保您在Breeze中启用了API访问

1. **速率限制错误**

- 降低请求频率
- 实现通话之间的延迟
- 在可用时使用批处理操作

1. **字段ID无效**

- 使用 `list_profile_fields` 获取当前字段ID
- 如果重新创建字段,字段ID可能会更改

1. **权限错误**

- 验证您的Breeze用户是否具有适当的权限
- 某些操作需要管理员级别的访问权限

### 调试

通过设置环境变量启用调试日志记录:```bash
DEBUG=breeze-chms-mcp-server

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

支持

这是一种非正式的整合。有关Breeze ChMS支持,请访问 技术支持.breezechms.com.

对于此MCP服务器的问题,请打开GitHub问题。

更新日志

v1.0.0

  • 初始版本
  • 为人员、事件、标签、表格、志愿者、家庭提供完整的API覆盖范围
  • 支持捐款和活动记录
  • 全面的错误处理和验证

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Breeze Chms MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Breeze Chms MCP Server 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Breeze Chms MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Breeze Chms MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Breeze Chms MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Breeze Chms MCP Server 能提供哪些能力?

资料显示约 30 个工具;能力标签包括 标签管理、JavaScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。