suzi-agri-mcp
Integrates NASA POWER climate data to provide 30-year agricultural climate baselines for Chinese agricultural regions, supporting weather and agricultural advisory tools.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@suzi-agri-mcp合江未来7天天气怎么样?有暴雨或霜冻农事预警吗?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
工具 | 功能 | 数据源 | 成本 |
| 11 个中国农业产区实时气象 + 7 天预报 + NASA POWER 30 年农业气候基准 | 免费无密钥 | |
| 暴雨 / 高温 / 霜冻 / 大风 农事预警扫描,输出等级与建议动作 | 同上 | 免费无密钥 |
预设产区:泸州 / 龙马潭 / 合江 / 先市(晚熟荔枝·真龙柚)/ 四川 / 云南 / 广西 / 海南 / 黑龙江 / 北京 / 山东。任意中文地名自动回落川南坐标。
⚠️ 免责声明:预警阈值均为「待校准推断参考值」,工具输出强制携带该标注,仅供农事参考,不应作为唯一的生产农艺决策依据。
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.mjs3. 接入你的 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 |
|
v0.3 | 经济作物规则包(桂圆/荔枝等)+ 认养成长卡片工具 |
长期 | 农业决策层编排工具 |
欢迎 Issue / PR。如果你在做农业 + AI 的结合,粟子农场在四川泸州龙马潭区 380 亩基地上真实使用这套工具。
📄 许可
MIT © 2026 四川粟子农业科技有限公司(Sichuan Suzi Agricultural Technology Co., Ltd.)
Available Tools
2 toolssuzi_weatherB
获取中国农业产区实时气象+7天预报+NASA POWER 30年气候基准(免费双源,覆盖泸州/合江/龙马潭等11个预设产区,支持任意中文地名回落川南坐标)
| Name | Required | Description | Default |
|---|---|---|---|
| crop | No | 作物,如:晚熟荔枝/真龙柚/蔬菜;缺省按产区推测 | |
| region | No | 产区名,如:泸州/合江/龙马潭/先市/黑龙江;默认泸州 |
TDQS
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.
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.
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.
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.
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.
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天气象并输出农事预警事件(暴雨/高温/霜冻/大风),含等级与建议动作。⚠️ 阈值为待校准推断参考值
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | 产区名,默认泸州 |
TDQS
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.
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.
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.
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.
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.
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.
2 tool updates
v0.1.0- First observed
suzi_weather - First observed
suzi_weather_alerts
TDQS
Scored across 2 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for current weather and multi-day forecasts worldwide, Chinese city names and output.
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
Smarter Weather MCP: forecasts, alerts, outlooks, observations, AQI, grids, and map imagery.
Weather data, forecast API, climate data, historical weather, alerts, agricultural & travel weather.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables users to get weather alerts and forecasts through natural language interactions. Provides real-time weather information and alert notifications via MCP tools.2-
- FlicenseNot gradedqualityDmaintenanceEnables 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-
- FlicenseNot gradedqualityDmaintenanceAn 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-
- FlicenseAqualityDmaintenanceProvides real-time weather and 3-day forecast for Chinese cities using the QWeather API, working with any MCP-compatible client.2-