Mcpservers

🚀 US Data.gov MCPサーバー

米国政府の公共データポータル（data.gov）のAPIモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このプロジェクトは、米国政府のdata.govポータルのAPIをMCPサーバーとしてラップし、AIツールが米国の公共データに簡単にアクセスし利用できるようにします。

✨ 主な機能

• 標準化されたアクセス：統一された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

# BLS労働統計サーバー
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

# BLS労働統計サーバー
pip install us-data-mcp.bls-labor

# EPA大気質サーバー
pip install us-data-mcp.epa-airquality

Claude Desktopの設定

Claude Desktopの設定ファイルにMCPサーバーを追加します。 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)

SECの企業提出書類および財務情報にアクセスします。

環境変数

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のフォームタイプの参照リストの取得

使用例

"Appleの最近の10-K提出書類を検索"
"ティッカーがMSFTの会社を検索"
"CIK 0000320193の財務情報を取得"
"Teslaの最近の内部者取引を表示"

FDA医薬品情報 (us-data-mcp.fda-drugs)

FDAの医薬品承認、リコール、および安全情報にアクセスします。

環境変数

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）

使用例

"LipitorのFDA承認情報を検索"
"最近の食品リコールを検索"
"心臓弁装置の情報を取得"
"アスピリンの有害事象報告を取得"

BLS労働統計 (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：BLSシリーズIDのデータを取得
  • パラメータ：
    • series_ids：シリーズIDのリスト（例：["LNS14000000"]）
    • start_year：開始年
    • end_year：終了年
• get_common_series：一般的なシリーズIDの参照リストを取得

使用例

"2020年から2023年までの全国の失業率を取得"
"インフレ分析のための消費者物価指数（CPI）データを検索"
"非農業部門の総雇用統計を表示"

EPA大気質 (us-data-mcp.epa-airquality)

EPAの大気質システム（AQS）の環境データにアクセスします。

環境変数

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

このスクリプトは、手順を1つずつ案内し、数分で新しい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キー

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。

謝辞

韓国のdata.go.kr MCPサーバー プロジェクトにインスパイアされています。

リソース

• Model Context Protocol Documentation
• Data.gov Developer Resources
• Census API Documentation
• SEC EDGAR API
• openFDA API
• BLS API Documentation
• EPA AQS API