USDA MCP-Server

MCP-Server, der die APIs von USDA NASS QuickStats und AMS Market News mit jedem MCP-kompatiblen KI-Modell verbindet. Dies ermöglicht Landwirten, Forschern und USDA-Mitarbeitern, Fragen zu US-Agrardaten in natürlicher Sprache zu stellen und präzise, datengestützte Antworten zu erhalten.

Entwickelt für den Challenge X Hackathon – 28. Februar bis 18. April 2026. Team: Root Access

Was dieses Tool leistet

Landwirte, Forscher und USDA-Mitarbeiter können Fragen zu US-Agrardaten in natürlicher Sprache stellen und erhalten präzise, datengestützte Antworten – ohne wissen zu müssen, was eine API ist oder wie man die Daten selbst findet.

Historische Daten (NASS QuickStats)

• "Wie hoch war der Maisertrag in Iowa im Jahr 2022?"

• "Wie hat sich die Sojaproduktion in Illinois von 2018 bis 2022 entwickelt?"

• "Wie viele Hektar Weizen wurden 2021 in Kansas gepflanzt?"

• "Welchen Preis erhielten Landwirte in Iowa für Mais im Jahr 2022?"

• "Wie hoch war die nationale Maisproduktion im Jahr 2022?"

Aktuelle Marktpreise (AMS Market News)

• "Was ist der aktuelle Maispreis in Iowa?"

• "Was ist der heutige Sojapreis in Illinois?"

• "Wo sollte ich mein Soja verkaufen – Iowa, Illinois oder Nebraska?"

• "Was ist der aktuelle Weizenpreis in Kansas?"

Related MCP server: USDA NASS MCP Server

Tools

Der Server stellt 4 MCP-Tools bereit:

Projektstruktur

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

Einrichtung

1. Repository klonen

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

2. Virtuelle Umgebung erstellen

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

3. Abhängigkeiten installieren

pip install -r requirements.txt

4. Eine .env-Datei im Stammverzeichnis erstellen

NASS_API_KEY=your_nass_key_here
AMS_API_KEY=your_ams_key_here

5. API-Schlüssel abrufen

NASS: Registrierung unter https://www.nass.usda.gov/developer/index.php

AMS: Registrierung unter https://mymarketnews.ams.usda.gov

Beide sind kostenlos und werden innerhalb weniger Minuten ausgestellt.

Verbindung zu Claude Desktop

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "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"
      }
    }
  }
}

Ersetzen Sie die Pfade durch Ihre tatsächlichen Python- und Projektpfade.

Verifizierte Daten — NASS QuickStats

Alle Abfragen wurden für Iowa, 2022, getestet und bestätigt.

Verifizierte Daten — AMS Market News

Aktuelle Preise bestätigt, Stand 2. April 2026.

Datenquellen

Funktionsweise

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

Sicherheit

Dieser Server adressiert alle 10 OWASP MCP Top 10 Risiken. Siehe SECURITY.md für vollständige Details.

Zusammenfassung:

• API-Schlüssel werden in .env gespeichert, niemals committet und aus allen Protokollen entfernt

• Nur-Lese-Server — nur GET-Anfragen, kein Schreibzugriff auf USDA-Systeme

• Eingabesanitisierung bei allen Tool-Argumenten

• Ratenbegrenzung auf 30 Anfragen pro Minute und Tool

• Erkennung von Prompt-Injection bei allen API-Antworten

• Vollständige Audit-Protokollierung jedes Tool-Aufrufs

Committen Sie niemals Ihre .env-Datei. Sie ist in .gitignore aufgeführt.

Team — Root Access

Hackathon

Challenge X+ USDA Zeitplan: 28. Februar bis 18. April 2026 Präsentation: 18. April 2026