Mcpservers

🚀 美國Data.gov MCP服務器

美國政府公共數據門戶（data.gov）的API模型上下文協議（MCP）服務器。它能讓AI工具便捷訪問美國公共數據，為各類應用提供數據支持。

🚀 快速開始

本項目將美國政府data.gov門戶的API封裝為MCP服務器，使AI工具能夠輕鬆訪問和利用美國公共數據。以下是使用這些服務器的基本步驟：

1. 安裝所需的MCP服務器。
2. 配置相關的AI工具，如Claude Desktop或Cline。
3. 利用服務器提供的工具進行數據查詢。

✨ 主要特性

• 標準化訪問：通過統一的MCP接口使用各種公共API。
• AI工具集成：可直接從Claude、Cline等AI助手訪問公共數據。
• 易於安裝：可通過pip或uv進行安裝。
• 類型安全：使用Pydantic進行強類型驗證。
• 開發者友好：基於模板可快速創建服務器。

📦 安裝指南

使用UV（推薦）

# 人口普查數據服務器
uv pip install us-data-mcp.census-data

# SEC EDGAR服務器
uv pip install us-data-mcp.sec-edgar

# FDA藥品服務器
uv pip install us-data-mcp.fda-drugs

# 勞工統計局服務器
uv pip install us-data-mcp.bls-labor

# EPA空氣質量服務器
uv pip install us-data-mcp.epa-airquality

使用pip

# 人口普查數據服務器
pip install us-data-mcp.census-data

# SEC EDGAR服務器
pip install us-data-mcp.sec-edgar

# FDA藥品服務器
pip install us-data-mcp.fda-drugs

# 勞工統計局服務器
pip install us-data-mcp.bls-labor

# EPA空氣質量服務器
pip install us-data-mcp.epa-airquality

Claude Desktop配置

將MCP服務器添加到Claude Desktop配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "us-data-mcp.census-data": {
      "command": "uvx",
      "args": ["us-data-mcp.census-data@latest"],
      "env": {
        "CENSUS_API_KEY": "your-api-key-here"
      }
    },
    "us-data-mcp.sec-edgar": {
      "command": "uvx",
      "args": ["us-data-mcp.sec-edgar@latest"]
    },
    "us-data-mcp.fda-drugs": {
      "command": "uvx",
      "args": ["us-data-mcp.fda-drugs@latest"]
    },
    "us-data-mcp.bls-labor": {
      "command": "uvx",
      "args": ["us-data-mcp.bls-labor@latest"],
      "env": {
        "BLS_API_KEY": "your-api-key-here"
      }
    },
    "us-data-mcp.epa-airquality": {
      "command": "uvx",
      "args": ["us-data-mcp.epa-airquality@latest"],
      "env": {
        "EPA_AQS_EMAIL": "your-email@example.com",
        "EPA_AQS_KEY": "your-api-key-here"
      }
    }
  }
}

注意：使用@latest可確保始終運行最新版本。

Cline配置

在VS Code的Cline擴展中配置MCP服務器：.vscode/cline_mcp_settings.json

{
  "mcpServers": {
    "us-data-mcp.census-data": {
      "command": "python",
      "args": ["-m", "us_data_mcp.census_data.server"],
      "env": {
        "CENSUS_API_KEY": "your-api-key-here"
      }
    }
  }
}

💻 使用示例

人口普查局數據（us-data-mcp.census-data）

環境變量

export CENSUS_API_KEY="your-api-key-here"  # 從https://api.census.gov/data/key_signup.html獲取

可用工具

• search_population：按地理區域搜索人口數據
  • 參數：
    • year：數據年份（例如，2020）
    • state：州FIPS代碼（2位數字）
    • county：縣FIPS代碼（3位數字，可選）
    • variables：要檢索的人口普查變量列表
• search_economic：搜索經濟指標
  • 參數：
    • year：數據年份
    • dataset：數據集名稱（例如，"acs/acs5"）
    • variables：經濟變量列表
    • geography：地理級別（州、縣等）

使用示例

"獲取2020年加利福尼亞州的人口數據"
"查找紐約縣的家庭收入中位數"
"顯示得克薩斯州的就業統計數據"

SEC EDGAR（us-data-mcp.sec-edgar）

環境變量

無需API密鑰 - 使用公共SEC EDGAR API。

可用工具

• search_company：按名稱、股票代碼或CIK搜索公司
  • 參數：
    • query：公司名稱、股票代碼或CIK
• get_company_facts：獲取公司財務事實（XBRL數據）
  • 參數：
    • cik：中央索引鍵
• get_insider_trades：獲取最近的內幕交易報告（Form 4）
  • 參數：
    • cik：中央索引鍵
    • limit：要檢索的交易數量（默認：20）
• get_form_types：獲取SEC表格類型的參考列表

使用示例

"查找蘋果公司最近的10 - K文件"
"搜索股票代碼為MSFT的公司"
"獲取CIK為0000320193的公司的財務事實"
"顯示特斯拉公司最近的內幕交易情況"

FDA藥品信息（us-data-mcp.fda-drugs）

環境變量

無需API密鑰 - 使用公共openFDA API。

可用工具

• search_drugs：搜索藥品數據庫
  • 參數：
    • brand_name：藥品品牌名稱（可選）
    • generic_name：通用名稱（可選）
    • application_number：FDA申請編號（可選）
    • limit：最大結果數（默認：10）
• search_recalls：搜索藥品召回信息
  • 參數：
    • product_description：產品描述
    • classification：召回分類（I、II、III）
    • status：召回狀態（進行中、已完成）
    • limit：最大結果數（默認：10）
• search_adverse_events：搜索不良事件報告
  • 參數：
    • drug_name：藥品名稱
    • reaction：特定反應/副作用（可選）
    • limit：最大結果數（默認：10）
• search_devices：搜索醫療設備
  • 參數：
    • device_name：設備名稱
    • limit：最大結果數（默認：10）
• search_all_recalls：搜索所有FDA召回信息（食品、藥品、設備）
  • 參數：
    • category：類別（食品、藥品、設備）
    • product_description：產品名稱或關鍵詞
    • limit：最大結果數（默認：10）

使用示例

"查找立普妥的FDA批准信息"
"搜索最近的食品召回信息"
"獲取心臟瓣膜設備的信息"
"獲取阿司匹林的不良事件報告"

勞工統計局（us-data-mcp.bls-labor）

環境變量

export BLS_API_KEY="your-api-key-here"  # 從https://www.bls.gov/developers/api_signature_v2.htm獲取

可用工具

• get_series_data：獲取勞工統計局系列ID的數據
  • 參數：
    • series_ids：系列ID列表（例如，["LNS14000000"]）
    • start_year：開始年份
    • end_year：結束年份
• get_common_series：獲取常見系列ID的參考列表

使用示例

"獲取2020年至2023年的全國失業率"
"查找用於通貨膨脹分析的CPI數據"
"顯示非農就業總統計數據"

EPA空氣質量（us-data-mcp.epa-airquality）

環境變量

export EPA_AQS_EMAIL="your-email@example.com"
export EPA_AQS_KEY="your-api-key-here"  # 從https://aqs.epa.gov/data/api/signup獲取

可用工具

• get_daily_air_quality：獲取每日空氣質量摘要
  • 參數：
    • param_code：汙染物參數代碼（例如，"44201"表示臭氧）
    • bdate：開始日期（YYYYMMDD）
    • edate：結束日期（YYYYMMDD）
    • state：2位州FIPS代碼
    • county：3位縣FIPS代碼（可選）
• get_common_aqs_parameters：獲取汙染物代碼的參考列表

使用示例

"獲取2023年7月加利福尼亞州的臭氧水平"
"查找洛杉磯縣的PM2.5水平"
"顯示EPA數據的常見空氣汙染物代碼"

📚 詳細文檔

開發環境設置

# 克隆倉庫
git clone https://github.com/sechan9999/us-data-mcp-servers.git
cd us-data-mcp-servers

# 安裝UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安裝依賴項
uv sync --dev

🚀 快速創建新的MCP服務器

使用自動化腳本（推薦）

最快的方法是使用提供的模板生成腳本：

# 運行交互式腳本
uv run python scripts/create_mcp_server.py

該腳本將逐步引導你完成過程，並在幾分鐘內生成一個新的MCP服務器。

手動使用模板

# 安裝Cookiecutter（如果需要）
uv pip install cookiecutter

# 從模板創建新服務器
uv run cookiecutter template/ -o src/

有關詳細的模板使用說明，請參閱 TEMPLATE_USAGE.md。

有關完整的開發者指南，請參閱 CONTRIBUTING.md。

運行測試

# 運行所有測試
uv run pytest

# 運行特定服務器的測試
uv run pytest src/census-data/tests/

API密鑰

🤝 貢獻

歡迎貢獻代碼！請參閱 CONTRIBUTING.md 獲取指南。

📄 許可證

本項目採用MIT許可證 - 詳情請參閱 LICENSE。

👏 致謝

本項目受 韓國data.go.kr MCP服務器 項目的啟發。

📚 資源

• 模型上下文協議文檔
• Data.gov開發者資源
• 人口普查API文檔
• SEC EDGAR API
• openFDA API
• 勞工統計局API文檔
• EPA AQS API