usda MCP

USDA MCP服务器

连接美国农业部NASS QuickStats和AMS市场新闻API的MCP服务器 任何兼容MCP的人工智能模型，允许农民、研究人员和美国农业部 工作人员就美国农业数据提出简单的英语问题，并获得 准确、数据支持的答案。

为挑战X黑客马拉松而建——2026年2月28日至4月18日。 团队：根访问

______________________________________________________________________

这有什么作用

农民、研究人员和美国农业部工作人员可以问一些简单的英语问题 了解美国农业数据，并获得准确的数据支持答案-- 而不需要知道什么是API或如何查找数据本身。

历史数据（NASS QuickStats）

• “2022年爱荷华州的玉米产量是多少？”
• “从2018年到2022年，伊利诺伊州的大豆产量趋势如何？”
• “2021年堪萨斯州种植了多少英亩小麦？”
• “2022年爱荷华州农民的玉米价格是多少？”
• “2022年全国玉米产量是多少？”

当前市场价格（AMS市场新闻）

• “爱荷华州目前的玉米价格是多少？”
• “今天伊利诺伊州的大豆价格是多少？”
• “我应该在哪里卖大豆——爱荷华州、伊利诺伊州还是内布拉斯加州？”
• “堪萨斯州目前的小麦价格是多少？”

______________________________________________________________________

工具

服务器公开了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

两者都是免费的，并在几分钟内发布。

______________________________________________________________________

连接到克劳德桌面

将此添加到 ~/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市场新闻

截至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

______________________________________________________________________

安全

此服务器解决了所有10个OWASP MCP Top 10风险。 看 安全.md 了解全部细节。

摘要：

• API密钥存储在 .env，从未提交，从所有日志中编辑
• 只读服务器——仅GET请求，对任何USDA系统都没有写访问权限
• 对所有工具参数进行输入净化
• 每个工具每分钟30个请求的速率限制
• 对所有API响应进行即时注入检测
• 每次工具调用的完整审计日志记录

永远不要承诺你的 .env 文件。它列在 .gitignore.

______________________________________________________________________

团队--根访问

______________________________________________________________________

黑客松

挑战X+美国农业部 时间线：2026年2月28日至4月18日 展览：2026年4月18日