MCP Statcan

🚀 統計カナダAPIとデータベース統合プロジェクト

このプロジェクトは、統計カナダ（Statistics Canada）のAPIとデータベースを統合するFastMCPサーバープロジェクトです。統計カナダのデータへのアクセス、処理、および保存機能を提供することを目的としています。

✨ 主な機能

• API統合：StatCan APIを通じてリアルタイムデータを取得できます。
• データベース統合：APIから取得したデータをSQLiteデータベースに保存し、直接データベースをクエリできます。
• モジュール化設計：FastMCPフレームワークを採用しており、拡張と保守が容易です。
• 高いパフォーマンス：uvをパッケージ管理ツールとして使用することで、インストール効率を向上させています。

📦 インストール

システム要件

• オペレーティングシステム：Windows、Mac、Linuxをサポートします。
• Pythonバージョン：3.10以上が必要です。

インストール手順

1. Pythonのインストール：

   • ダウンロード先：python.org
   • インストール時に「PythonをPATHに追加」を選択してください。

2. uvパッケージ管理ツールのインストール：

   curl -fsSL https://astral.sh/uv/install.sh | bash  # Mac/Linux
   # またはWindowsでは：
   # curl.exe -fsSL https://astral.sh/uv/install.ps1 -o install.ps1; powershell -ExecutionPolicy Bypass -File install.ps1
   

3. プロジェクトの依存関係のインストール：

   uv pip install fastmcp httpx pydantic
   

4. コードリポジトリのクローン：

   git clone https://github.com/Aryan-Jhaveri/mcp-statcan.git
   cd mcp-statcan
   

プロジェクトの実行

# サーバーの起動
uv run --with fastmcp --with httpx sh -c "cd mcp-statcan && python -m src.server"

📚 ドキュメント

Claude Desktopの設定

1. 設定ファイルの編集：

   • Claudeデスクトップアプリを開き、設定画面（⌘ + ,）に移動します。
   • 開発者オプションで「設定を編集」を選択します。

2. サーバー設定の追加： /path/to/mcp-statcanを実際のプロジェクトパスに置き換えてください：

   {
     "mcpServers": {
       "StatCanAPI_DB_Server": {
         "command": "uv",
         "args": [
           "run",
           "--with", "fastmcp",
           "--with", "httpx", 
           "sh",
           "-c",
           "cd /path/to/mcp-statcan && python -m src.server"
         ]
       }
     }
   }
   

既知の問題と制限

• SSL検証：現在、開発環境では無効になっています。本番環境では有効にすることをおすすめします。
• Claudeの動作：循環または複数回のREST呼び出しが発生する場合があります。
• データ検証：使用前に、統計カナダの公式データソースと照合してください。
• セキュリティ問題：クエリ検証の基礎を確立し、信頼できない入力を処理しないようにしてください。
• パフォーマンス制限：一部のAPIは大量のデータ要求時にタイムアウトする場合があります。

💻 使用例

API操作

# 雇用に関連するデータテーブルを検索
tables = await search_cancad_statistics()

# リアルタイムの統計データを取得
statistics_data = await fetch_statcan_data()

データベース操作

# APIから取得したデータをデータベースに保存
save_to_database(statistics_data)

# データベースを直接クエリ
query_results = database_query("SELECT * FROM statistics")

プロジェクト貢献者

• 主要開発者：Aryan Zarei
• 保守チーム：統計カナダオープンデータチーム

詳細情報については、プロジェクトドキュメントを参照してください。