农业数据API服务器

用于美国农业部NASS API的MCP服务器

这 美国农业部国家农业统计局API，被称为 快速统计，包含美国农业生产的调查和人口普查数据。

NASS API访问

请求API密钥 这里.

工具

get_full_dataset(query: Query) -> str

获取给定商品、位置和时间的所有可用数据。

论据：

• query (Query)：有三个键的词典， "commodity", "location"，以及 "time"，每个都有一个参数和值对字典。

退货：

• str：字符串形式的完整响应文本

get_db_record_count(query: Query) -> str

获取给定商品在某个位置和时间的数据库记录的数量或计数。

论据：

• query (Query)：有三个键的词典， "commodity", "location"，以及 "time"，每个都有一个参数和值对字典。

退货：

• str：具有一个键的JSON数据字符串， "count"，以及记录数的值。

get_param_values(query: ParameterQuery) -> str

按名称获取查询参数的所有可能值。

论据：

• parameter (ParameterQuery)：单键词典， "param"，以及参数名称的值以获取其值。

退货：

• str：JSON数据字符串，包含参数名称及其所有可能值，以列表形式显示。

入门

我强烈建议使用 紫外线 用于包和虚拟环境管理。

码头工人

这 Dockerfile 设置为使用默认设置运行MCP服务器。使用 make，您可以构建映像并运行容器：

• build：从以下内容构建映像 Dockerfile
• run：使用默认设置运行MCP服务器（例如。 localhost, 8000:8000)

捷径

安装命令

如果你有 make, uv，并且在macOS/Linux上运行 make setup 这应该是你开始这个项目所需要的一切。

漫长的路

安装

激活您的虚拟环境，然后：

pip install -r requirements.txt

.env

复制 .env.example 到一个 .env 文件。替换以下值 NASS_API_KEY 使用您的NASS API密钥。

配置

有几个配置选项可以更改MCP服务器的功能。

以下配置可用 环境变量:

以下配置可用 命令行参数