plant-intel

一个为编码代理提供结构化植物数据以用于花园规划的 MCP 服务器：物种养护档案、能自我解释的伴生检查，以及根据十年观测天气得出的霜冻日期种植窗口。

companion_check("tomato", "potato")
  -> bad: both are Solanaceae. Same-family crops share soilborne diseases and
     compete for the same rotation slot, so plant them apart and rotate the bed.

为什么为此使用 MCP 服务器

模型在被问及花园规划时，会乐于给出看似合理的间距数字和伴生种植建议。其中大部分是民间传说，而且没有一条是可追溯的。有三点使得这值得做成一个服务器而不是一段提示词：

1. 数据真实且有引用。 每条记录都说明其来源和许可协议。

2. 缺口是可见的。 当上游层级隐藏某个字段时，响应会明确说明。当没有来源发布某个数字时，它会保持为 null 并附上解释，而不是被填充。

3. 结论带有机制。 companion_check 从不会因为某个园艺博客这么说就断定“它们很相配”。它会根据养护数据中的证据说明原因，并在完全没有证据时承认这一点。

Related MCP server: nasa-exoplanet-mcp

工具

每个工具都返回紧凑的 JSON。没有 HTML，没有页面转储。

companion_check 返回机制，而非民间传说

此服务器来源清单中的 API 均不发布植物相克关系——Permapeople 只列出“伴生”链接——因此无法简单查得“好/坏/中性”的答案。与其复述园艺传说，不如从养护数据中已有的证据推导出负面情况：

风险机制的优先级高于正面记录，但所有匹配的理由都会被返回，包括被覆盖的那条，因此混合配对仍然清晰可读。neutral 结论会明确表示这是缺乏证据，而非兼容性的证据。

planting_window 不会猜测作物时令

给它坐标，它就会根据 Open-Meteo 整整十年的每日最低气温，推导出春季最后一次霜冻的中位数日期、秋季第一次霜冻日期、季节长度以及该地的 USDA 耐寒区——然后将其与该植物公布的耐寒范围进行核对。已根据公布的正常值进行验证：

它不会做的是凭空捏造作物那一半。此清单中的来源均不发布成熟天数或耐霜等级，因此只有在您自己提供 days_to_maturity 和 frost_tolerance 时，才会出现移栽和播种日期。这种划分是经过深思熟虑的：此服务器负责气候那一半，调用方负责作物那一半。

南半球的站点按各自的生长季读取。按日历年分组会将南半球的夏季一分为二，并报告大约一天的无霜窗口。

安装

需要 Node 20 或更高版本以及免费的 Perenual API 密钥。

npm install -g plant-intel-mcp

或者直接从仓库运行：

git clone https://github.com/wyattlindsey/plant-intel-mcp.git && cd plant-intel-mcp && npm install && npm run build

Claude Code

claude mcp add plant-intel --env PERENUAL_API_KEY=your-key -- npx -y plant-intel-mcp

Claude Desktop

在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "plant-intel": {
      "command": "npx",
      "args": ["-y", "plant-intel-mcp"],
      "env": {
        "PERENUAL_API_KEY": "your-key"
      }
    }
  }
}

配置

缺少 Perenual 密钥不会阻止服务器运行。工具仍会列出，每次调用都会返回需要设置的变量以及获取密钥的位置。

来源及其限制

直截了当地说，因为这些限制决定了服务器能诚实地回答什么。

由于每天 100 次的上限，服务器会积极缓存（物种数据 30 天，天气档案 90 天），并守护每日预算，拒绝花费没有的请求，并在拒绝时说明重置时间。缓存命中永远不会计入其中。

plant_details 从不返回间距。这里没有来源发布该数据，带有注释的 null 比一个无人负责的数字更有用。

开发

npm test          # unit and protocol tests, no network
npm run typecheck
npm run build
npm run test:live # opt-in; hits real APIs and spends quota

实时测试套件用于检测漂移。测试夹具是根据已发布的文档构建的，因此它断言映射器读取的每个字段在上游仍然存在。其 Open-Meteo 测试无需凭据，可在任何地方运行。

有关架构和约定，请参阅 CLAUDE.md。

许可证

MIT。请参阅 LICENSE。

通过此服务器检索的数据仍受其来源条款的约束——请参阅上表。特别是，Perenual 的免费层是非商业性的，而 Permapeople 的数据是相同方式共享的。