MCP Statcan

🚀 統計加拿大API與數據庫集成項目

本項目是一個FastMCP服務器項目，致力於集成統計加拿大（Statistics Canada）的API和數據庫。其核心價值在於為用戶提供便捷的統計加拿大數據訪問、處理和存儲功能，極大地提升了數據利用效率。

🚀 快速開始

本項目是集成統計加拿大（Statistics Canada）API和數據庫的FastMCP服務器項目，能實現對統計加拿大數據的訪問、處理和存儲。以下是快速啟動項目的步驟：

1. 按照安裝指南完成項目的安裝與配置。
2. 參考使用示例進行API操作和數據庫操作。

✨ 主要特性

• 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"
         ]
       }
     }
   }
   

💻 使用示例

基礎用法

# 搜索與就業相關的數據表
tables = await search_cancad_statistics()

# 獲取即時統計數據
statistics_data = await fetch_statcan_data()

# 將API數據存入數據庫
save_to_database(statistics_data)

# 直接查詢數據庫
query_results = database_query("SELECT * FROM statistics")

高級用法

# 這裡可以根據實際的高級場景進行說明，例如複雜的數據處理或多表查詢等
# 目前原文檔未提供高級用法示例，可根據實際情況補充

📚 詳細文檔

更多詳細信息請參考項目文檔。

🔧 技術細節

項目結構

src/
├── config.py            # 配置加載（如數據庫憑證、API基礎URL）
├── server.py            # 主FastMCP服務器定義及工具註冊
└── __init__.py          # 包初始化文件

已知問題與限制

• SSL驗證：目前開發環境下關閉，建議生產環境啟用，以保障數據傳輸的安全性。
• Claude行為：可能出現循環或多次REST調用的情況，使用時需留意。
• 數據校驗：使用前請交叉核對官方統計加拿大來源數據，確保數據的準確性。
• 安全問題：查詢驗證基礎，避免處理未信任輸入，防止安全漏洞。
• 性能限制：部分接口在大數據請求時可能超時，可根據實際情況優化請求策略。

📄 許可證

原文檔未提及許可證信息，若有相關內容可補充在此處。

👥 項目貢獻者

• 主要開發者：Aryan Zarei
• 維護團隊：統計加拿大開放數據小組