USDA MCPサーバー

USDAのNASS QuickStatsおよびAMS Market News APIを、MCP互換のAIモデルに接続するMCPサーバーです。これにより、農家、研究者、USDA職員が米国の農業データについて平易な英語で質問し、正確でデータに基づいた回答を得ることができます。

Challenge Xハッカソン（2026年2月28日〜4月18日）向けに構築。 チーム: Root Access

このサーバーでできること

農家、研究者、USDA職員は、米国の農業データについて平易な英語で質問し、正確でデータに基づいた回答を得ることができます。APIとは何か、あるいは自分でデータを検索する方法を知る必要はありません。

過去のデータ (NASS QuickStats)

• "What was the corn yield in Iowa in 2022?" (2022年のアイオワ州のトウモロコシの収穫量は？)

• "How has soybean production in Illinois trended from 2018 to 2022?" (2018年から2022年までのイリノイ州の大豆生産量の推移は？)

• "How many acres of wheat were planted in Kansas in 2021?" (2021年にカンザス州で小麦は何エーカー作付けされたか？)

• "What price did Iowa farmers receive for corn in 2022?" (2022年にアイオワ州の農家が受け取ったトウモロコシの価格は？)

• "What was national corn production in 2022?" (2022年の全米のトウモロコシ生産量は？)

現在の市場価格 (AMS Market News)

• "What is the current corn price in Iowa?" (アイオワ州の現在のトウモロコシ価格は？)

• "What is today's soybean price in Illinois?" (今日のイリノイ州の大豆価格は？)

• "Where should I sell my soybeans — iowa, illinois, or nebraska?" (大豆はどこで売るべきか — アイオワ、イリノイ、ネブラスカ？)

• "What is the current wheat price in Kansas?" (カンザス州の現在の小麦価格は？)

Related MCP server: USDA NASS MCP Server

ツール

このサーバーは4つのMCPツールを公開しています：

プロジェクト構成

usda-mcp/
├── clients/
│   ├── nass_client.py       # NASS QuickStats API wrapper
│   └── ams_client.py        # AMS Market News API wrapper
├── server/
│   ├── main.py              # MCP server — 4 tools
│   ├── security.py          # OWASP MCP Top 10 mitigations
│   └── tools/
│       └── __init__.py
├── tests/
│   └── qa_log.csv           # Q&A evaluation log
├── demo/
│   └── app.py               # Demo interface (planned)
├── logs/
│   └── usda_nass_server.log # Auto-generated server log
├── .env                     # API keys (never committed)
├── .env.example             # Template for API keys
├── requirements.txt         # Pinned dependencies
├── SECURITY.md              # OWASP MCP Top 10 documentation
└── README.md

セットアップ

1. リポジトリのクローン

git clone https://github.com/RolakeOkans/usda-mcp.git
cd usda-mcp

2. 仮想環境の作成

python -m venv .venv
source .venv/bin/activate

3. 依存関係のインストール

pip install -r requirements.txt

4. ルートフォルダに .env ファイルを作成

NASS_API_KEY=your_nass_key_here
AMS_API_KEY=your_ams_key_here

5. APIキーの取得

NASS: https://www.nass.usda.gov/developer/index.php で登録

AMS: https://mymarketnews.ams.usda.gov で登録

どちらも無料で、数分で発行されます。

Claude Desktopへの接続

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加してください：

{
  "mcpServers": {
    "usda-nass": {
      "command": "/path/to/your/python",
      "args": ["/path/to/usda-mcp/server/main.py"],
      "env": {
        "NASS_API_KEY": "your_key_here",
        "AMS_API_KEY": "your_key_here"
      }
    }
  }
}

パスは実際のPythonおよびプロジェクトのパスに置き換えてください。

検証済みデータ — NASS QuickStats

すべてのクエリは、2022年のアイオワ州についてテストされ、動作が確認されています。

検証済みデータ — AMS Market News

現在の価格は2026年4月2日時点で動作確認済みです。

データソース

仕組み

User asks a plain English question
        ↓
AI model reads the question and decides which tool to call
        ↓
MCP server validates and sanitizes the input
        ↓
NASS or AMS API returns the raw data
        ↓
Server scans response for security issues
        ↓
AI model interprets the data and returns a plain English answer
        ↓
All tool calls logged to logs/usda_nass_server.log

セキュリティ

このサーバーは、OWASP MCP Top 10の全10リスクに対処しています。 詳細は SECURITY.md を参照してください。

概要:

• APIキーは .env に保存され、コミットされることはなく、すべてのログから除外されます

• 読み取り専用サーバー — GETリクエストのみ、USDAシステムへの書き込みアクセス権なし

• すべてのツール引数に対する入力サニタイズ

• ツールごとに1分あたり30リクエストのレート制限

• すべてのAPIレスポンスに対するプロンプトインジェクション検出

• すべてのツール呼び出しの完全な監査ログ

.env ファイルは絶対にコミットしないでください。.gitignore にリストされています。

チーム — Root Access

ハッカソン

Challenge X+ USDA 期間: 2026年2月28日〜4月18日 発表: 2026年4月18日