Experimental MCP Server for CommCare Connect (ccc) について
CommCare Connect の統計を照会する実験的な MCP サーバーです。収益、支払い、アクティブユーザー、訪問数を、日付やプログラム、組織で絞り込めます。
主な機能
- 01ダッシュボード統計の照会
- 02日付範囲による絞り込み
- 03プログラムや組織による絞り込み
- 04認証トークンの使用
活用シーン
- 01収益と支払い額の確認
- 02アクティブユーザー数と訪問数の確認
- 03指定日付やプログラムの統計確認
MCP 対応
CommCare Connect の全体統計を MCP サーバー経由でクライアントに公開します。Python MCP SDK を使用し、Claude Code などで利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
CommCare Connect（ccc）向け実験的 MCP サーバー
これは CommCare Connect 向けの実験的な MCP サーバーです。 簡単な動画チュートリアルはこちらをご覧ください。
claude codeで使用するには、このフォルダーでclaudeを実行します。
設定方法は.mcp.jsonで確認できます。
別のツールを使用する場合は、宣言を適宜変更してください。
システムにuvをインストールする必要があります。また、uv実行ファイルとserver.pyファイルの絶対パスを指定する必要がある場合があります。
このプロジェクトはPython MCP SDKを基盤として構築されています。
使用方法
現時点では、プログラムダッシュボードで使用されるグローバル統計 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/に対して実行することもできます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。