USDA MCP Server

MCP-сервер, который подключает API NASS QuickStats и AMS Market News Министерства сельского хозяйства США (USDA) к любой MCP-совместимой модели ИИ, позволяя фермерам, исследователям и сотрудникам USDA задавать вопросы на обычном английском языке о сельскохозяйственных данных США и получать точные, подтвержденные данными ответы.

Создано для хакатона Challenge X — с 28 февраля по 18 апреля 2026 года. Команда: Root Access

Что это делает

Фермеры, исследователи и сотрудники USDA могут задавать вопросы на обычном английском языке о сельскохозяйственных данных США и получать точные, подтвержденные данными ответы — без необходимости знать, что такое API или как самостоятельно искать данные.

Исторические данные (NASS QuickStats)

• "Какова была урожайность кукурузы в Айове в 2022 году?"

• "Какова динамика производства сои в Иллинойсе с 2018 по 2022 год?"

• "Сколько акров пшеницы было засеяно в Канзасе в 2021 году?"

• "Какую цену получили фермеры Айовы за кукурузу в 2022 году?"

• "Каков был объем производства кукурузы в стране в 2022 году?"

Текущие рыночные цены (AMS Market News)

• "Какова текущая цена на кукурузу в Айове?"

• "Какова сегодняшняя цена на сою в Иллинойсе?"

• "Где мне лучше продать сою — в Айове, Иллинойсе или Небраске?"

• "Какова текущая цена на пшеницу в Канзасе?"

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

Текущие цены подтверждены по состоянию на 2 апреля 2026 года.

Источники данных

Как это работает

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

Безопасность

Этот сервер учитывает все 10 рисков из списка OWASP MCP Top 10. Полную информацию см. в SECURITY.md.

Кратко:

• API-ключи хранятся в .env, никогда не коммитятся, удаляются из всех логов

• Сервер только для чтения — только GET-запросы, нет прав на запись в любую систему USDA

• Санитизация ввода для всех аргументов инструментов

• Ограничение частоты запросов (rate limiting) до 30 запросов в минуту на инструмент

• Обнаружение промпт-инъекций во всех ответах API

• Полное ведение журнала аудита каждого вызова инструмента

Никогда не коммитьте ваш файл .env. Он указан в .gitignore.

Команда — Root Access

Хакатон

Challenge X+ USDA Сроки: с 28 февраля по 18 апреля 2026 года Демонстрация: 18 апреля 2026 года