Skip to main content
Glama

suzi-agri-mcp · 中国首个农业 MCP Server

China's first Chinese-language MCP Server for agricultural regions. 把中国农业产区数据源按 MCP(Model Context Protocol)标准封装,让所有可自行配置 MCP 的 AI 客户端(Claude Desktop / Cursor / Cherry Studio / Kimi Code 等)即插即用获得农业数据能力。 (注:豆包 / Kimi 等 C 端 App 目前不支持用户自行添加第三方 MCP,请使用支持 MCP 配置的桌面端或 CLI 客户端。)

由 四川粟子农业科技有限公司(粟子农场) 开源 · MIT License · 零第三方依赖 · 免费、无需 API 密钥

官方说明页:https://suzi-agri.com/mcp


✨ 工具集(v0.1)

工具

功能

数据源

成本

suzi_weather

11 个中国农业产区实时气象 + 7 天预报 + NASA POWER 30 年农业气候基准

Open-Meteo + NASA POWER

免费无密钥

suzi_weather_alerts

暴雨 / 高温 / 霜冻 / 大风 农事预警扫描,输出等级与建议动作

同上

免费无密钥

预设产区:泸州 / 龙马潭 / 合江 / 先市(晚熟荔枝·真龙柚)/ 四川 / 云南 / 广西 / 海南 / 黑龙江 / 北京 / 山东。任意中文地名自动回落川南坐标。

⚠️ 免责声明:预警阈值均为「待校准推断参考值」,工具输出强制携带该标注,仅供农事参考,不应作为唯一的生产农艺决策依据。

Related MCP server: China Weather MCP Server

🚀 快速开始

1. 环境要求

  • Node.js ≥ 18(无任何 npm 依赖,克隆即用)

2. 运行

git clone https://github.com/suzi-agri/suzi-agri-mcp.git
cd suzi-agri-mcp
node server.mjs

3. 接入你的 AI 客户端(stdio 传输)

以 Claude Desktop / Cursor 为例,在 MCP 配置中加入:

{
  "mcpServers": {
    "suzi-agri-mcp": {
      "command": "node",
      "args": ["/你的路径/suzi-agri-mcp/server.mjs"]
    }
  }
}

4. 冒烟测试(可选)

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05"}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list"}\n{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"suzi_weather_alerts","arguments":{"region":"合江"}}}\n' | node server.mjs

🆚 为什么用 MCP 而不是直接调 API?

维度

普通农业天气 API

suzi-agri-mcp

接入方式

逐家注册密钥、读文档、写对接代码

标准协议,MCP 客户端即插即用

换 AI 客户端

重新对接一遍

零改动

农业语义

裸数据,自己翻译

产区预设 + 农事预警阈值 + 30 年气候基准

中文产区

国外源需自行换算

11 个中国农业产区开箱即用

成本

多有订阅费/配额

免费无密钥(MIT)

🗺 路线图

阶段

内容

v0.1 ✅

weather 双工具(实时气象 / 农事预警),零依赖 stdio

v0.2

suzi_price(中国农产品批发价格指数)+ suzi_farm_calendar(24 节气农事日历)

v0.3

经济作物规则包(桂圆/荔枝等)+ 认养成长卡片工具

长期

农业决策层编排工具

欢迎 Issue / PR。如果你在做农业 + AI 的结合,粟子农场在四川泸州龙马潭区 380 亩基地上真实使用这套工具。

📄 许可

MIT © 2026 四川粟子农业科技有限公司(Sichuan Suzi Agricultural Technology Co., Ltd.)

Available Tools

2 tools
suzi_weatherB

获取中国农业产区实时气象+7天预报+NASA POWER 30年气候基准(免费双源,覆盖泸州/合江/龙马潭等11个预设产区,支持任意中文地名回落川南坐标)

ParametersJSON Schema
NameRequiredDescriptionDefault
cropNo作物,如:晚熟荔枝/真龙柚/蔬菜;缺省按产区推测
regionNo产区名,如:泸州/合江/龙马潭/先市/黑龙江;默认泸州

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the behavioral burden. It usefully discloses data provenance (free dual-source, NASA POWER 30-year baseline, 7-day forecast) and fallback behavior for arbitrary Chinese place names, but says nothing about read-only nature, rate limits, auth, or failure modes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single dense sentence, front-loaded with the verb and the data types the tool returns, with detail tucked into one trailing parenthetical. Efficient, though the parenthetical is information-packed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema and no annotations, so the description should describe more about the returned structure (how real-time, forecast, and baseline are organized). It covers sources and coverage but leaves the response shape unspecified.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters including defaults. The description adds only marginal meaning (the arbitrary-place-name fallback to southern Sichuan coordinates), which is correct at the 3 baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (获取) and a rich, well-scoped resource set: real-time weather + 7-day forecast + NASA POWER 30-year climate baseline for agricultural regions. The resource type (weather data) inherently differs from the sibling suzi_weather_alerts, but the description never names or contrasts that sibling explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains what data it returns and its coverage, but gives no when-to-use guidance and never mentions suzi_weather_alerts or any condition for choosing between them. The agent must infer usage from the resource itself.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suzi_weather_alertsA

扫描未来7天气象并输出农事预警事件(暴雨/高温/霜冻/大风),含等级与建议动作。⚠️ 阈值为待校准推断参考值

ParametersJSON Schema
NameRequiredDescriptionDefault
regionNo产区名,默认泸州

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden, and it does disclose meaningful behavior: the 7-day scan window, the four alert categories emitted, that each alert carries a level and a suggested action, and a candid reliability caveat that thresholds are uncalibrated inferred values. It omits any auth, rate-limit, or failure-mode context, keeping it below 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One dense sentence front-loads the scan window and output, followed by a short caveat sentence. No filler, though the caveat could be tidier.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-optional-param tool with no output schema and no annotations, the description adequately covers what is produced (categorized alerts with levels and actions) and flags data reliability. Only the lack of relational guidance versus suzi_weather keeps it from a 5.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is a single optional parameter (region) whose schema description is fully covered, including its 泸州 default, so the schema already does the work. The description adds nothing about region semantics; baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (扫描) and resource (未来7天气象) and specifies the output artifact (农事预警事件 with 等级与建议动作), which implicitly separates it from the sibling suzi_weather's raw forecast. It does not explicitly name the sibling or contrast the two, so it falls short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: an agent can infer this is for agricultural warning checks over the next week, but there is no explicit when-to-use statement, no exclusions, and no reference to suzi_weather as the plain-forecast alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv0.1.0
    • First observedsuzi_weather
    • First observedsuzi_weather_alerts

TDQS

B3.4/5.0

Scored across 2 tools

Disambiguation4/5

The two tools have distinct purposes: suzi_weather fetches meteorological data while suzi_weather_alerts derives actionable warning events. There is mild conceptual overlap since alerts depend on the same weather data, but an agent can clearly choose between them.

Naming Consistency4/5

Both tools use a consistent snake_case pattern with the shared suzi_ prefix and weather stem. The only minor deviation is the redundant double 'weather' in suzi_weather_alerts, but the pattern is predictable.

Tool Count3/5

Two tools is thin for a server branded as an agriculture MCP; the surface is essentially a single weather-data capability plus a derivative alerts view. It is not extreme, but it feels under-scoped for the stated domain.

Completeness2/5

Coverage is limited to weather and weather-derived alerts, with no soil, planting calendars, crop advice, or market/production data that an 'agri-mcp' would be expected to provide. There are significant gaps beyond the weather vertical.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Enables users to get weather alerts and forecasts through natural language interactions. Provides real-time weather information and alert notifications via MCP tools.
    2
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables querying weather forecasts (1-7 days) and meteorological warnings for Chinese cities using the QWeather API. Supports detailed weather data including temperature, humidity, wind, precipitation, UV index, and real-time weather alerts.
    2
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server integrated with the QWeather API that provides real-time weather forecasts and meteorological warnings for AI assistants. It enables users to query current conditions and disaster alerts for specific cities or coordinates.
    18 npm
    -