Servidor MCP del USDA

Servidor MCP que conecta las API de NASS QuickStats y AMS Market News del USDA a cualquier modelo de IA compatible con MCP, permitiendo a agricultores, investigadores y personal del USDA realizar preguntas en lenguaje sencillo sobre datos agrícolas de EE. UU. y obtener respuestas precisas y respaldadas por datos.

Creado para el Hackathon Challenge X — 28 de febrero al 18 de abril de 2026. Equipo: Root Access

¿Qué hace esto?

Los agricultores, investigadores y el personal del USDA pueden hacer preguntas en lenguaje sencillo sobre datos agrícolas de EE. UU. y obtener respuestas precisas y respaldadas por datos, sin necesidad de saber qué es una API o cómo encontrar los datos por sí mismos.

Datos históricos (NASS QuickStats)

• "¿Cuál fue el rendimiento del maíz en Iowa en 2022?"

• "¿Cómo ha sido la tendencia de la producción de soja en Illinois de 2018 a 2022?"

• "¿Cuántos acres de trigo se sembraron en Kansas en 2021?"

• "¿Qué precio recibieron los agricultores de Iowa por el maíz en 2022?"

• "¿Cuál fue la producción nacional de maíz en 2022?"

Precios actuales del mercado (AMS Market News)

• "¿Cuál es el precio actual del maíz en Iowa?"

• "¿Cuál es el precio de la soja hoy en Illinois?"

• "¿Dónde debería vender mi soja: Iowa, Illinois o Nebraska?"

• "¿Cuál es el precio actual del trigo en Kansas?"

Related MCP server: USDA NASS MCP Server

Herramientas

El servidor expone 4 herramientas MCP:

Estructura del proyecto

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

Configuración

1. Clonar el repositorio

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

2. Crear un entorno virtual

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

3. Instalar dependencias

pip install -r requirements.txt

4. Crear un archivo .env en la carpeta raíz

NASS_API_KEY=your_nass_key_here
AMS_API_KEY=your_ams_key_here

5. Obtener tus claves de API

NASS: Regístrate en https://www.nass.usda.gov/developer/index.php

AMS: Regístrate en https://mymarketnews.ams.usda.gov

Ambas son gratuitas y se emiten en cuestión de minutos.

Conectar a Claude Desktop

Añade esto a ~/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"
      }
    }
  }
}

Reemplaza las rutas con tus rutas reales de Python y del proyecto.

Datos verificados — NASS QuickStats

Todas las consultas probadas y confirmadas como funcionales para Iowa, 2022.

Datos verificados — AMS Market News

Precios actuales confirmados como funcionales al 2 de abril de 2026.

Fuentes de datos

Cómo funciona

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

Seguridad

Este servidor aborda los 10 riesgos principales de OWASP MCP. Consulta SECURITY.md para obtener todos los detalles.

Resumen:

• Claves de API almacenadas en .env, nunca confirmadas (committed), redactadas de todos los registros

• Servidor de solo lectura: solo solicitudes GET, sin acceso de escritura a ningún sistema del USDA

• Sanitización de entradas en todos los argumentos de herramientas

• Limitación de tasa a 30 solicitudes por minuto por herramienta

• Detección de inyección de prompts en todas las respuestas de la API

• Registro de auditoría completo de cada llamada a la herramienta

Nunca confirmes (commit) tu archivo .env. Está listado en .gitignore.

Equipo — Root Access

Hackathon

Challenge X+ USDA Cronograma: 28 de febrero al 18 de abril de 2026 Presentación: 18 de abril de 2026