Experimental MCP Server for CommCare Connect (ccc)

基本能力

产品定位

commcare-connect-mcp 是一个实验性的 MCP 服务器，用于与 CommCare Connect 平台交互，主要提供数据查询功能。

核心功能

• 查询全局统计 API
• 获取收入、支付、活跃用户和访问统计等数据
• 支持按日期范围、程序或组织 ID 筛选数据

适用场景

• 数据分析：获取平台的使用情况和财务数据
• 监控：跟踪平台的活跃用户和访问情况
• 报告生成：基于特定时间范围或组织的数据生成报告

工具列表

• uv：需要安装的工具，用于运行服务器
• claude：可以与该 MCP 服务器配合使用的工具

常见问题解答

• 如何获取认证令牌？ 可以通过超级用户访问特定 URL 获取，或使用 curl 命令创建新令牌
• 如何测试令牌有效性？ 使用带有令牌的 curl 命令访问 API 端点

使用教程

使用依赖

需要安装 uv 工具

安装教程

1. 确保已安装 uv
2. 克隆项目到本地
3. 修改 .mcp.json 文件中的配置（如需要）

调试方式

1. 将 .mcp.json 中的 SERVER_ENDPOINT 改为 http://localhost:8000
2. 运行开发服务器
3. 获取 API 令牌
4. 使用 curl 命令测试 API 端点

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。