Experimental MCP Server for CommCare Connect (ccc)

CommCare Connect (ccc) 实验性 MCP 服务

这是一个用于 CommCare Connect 的实验性 MCP 服务。 你可以在这里观看快速演示视频。

如需与 claude code 配合使用，可以在此文件夹中运行 claude。 你可以查看 .mcp.json，了解其配置方式。 如果要使用其他工具，可以相应地修改声明。 你需要在系统上安装 uv，并且可能需要指定 uv 可执行文件和 server.py 文件的绝对路径。

此项目基于 Python MCP SDK 构建。

用法

目前，此服务只能查询全局统计 API，该 API 由 项目仪表板使用。 因此，你可以向它询问收入和付款金额、活跃用户 以及访问统计数据，也可以指定日期范围（如果知道 ID，还可以指定项目或组织）。

获取身份验证令牌

获取身份验证令牌最简单的方式是以超级用户身份访问 https://connect.dimagi.com/admin/authtoken/tokenproxy/ 并查找与你的电子邮件关联的令牌。

如果你没有任何令牌，可以运行以下命令，并替换为你的用户名和密码：

curl -X POST -d "[email protected]&<password=***" https://connect.dimagi.com/auth-token/

此命令会创建一个令牌，并在命令行中打印其值。

你可以使用以下命令测试令牌是否有效：

curl -H "Authorization: Token YOUR_TOKEN" "https://connect.dimagi.com/admin_reports/api/dashboard_stats/?from_date=2024-01-01&to_date=2024-12-31"

开发

你可以将 .mcp.json 中的 SERVER_ENDPOINT 改为 http://localhost:8000，以便在开发服务上进行测试。 这需要你运行开发服务，并按照上述相同流程获取 API 令牌。

你也可以按照类似流程，在 https://connect-staging.dimagi.com/ 上运行。