plant-intel

コーディングエージェントにガーデニング計画用の構造化された植物データを提供するMCPサーバーです。種のケアプロファイル、根拠を説明するコンパニオンチェック、10年間の観測気象から導き出した霜日ベースの植え付け期間を提供します。

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サーバーなのか

ガーデニング計画について尋ねられたモデルは、もっともらしい間隔の数値やコンパニオンプランティングのアドバイスを気軽に生成します。そのほとんどは民間伝承であり、追跡可能なものは何もありません。プロンプトではなくサーバーにする価値がある理由は3つあります。

1. データは実在し、出典が明記されています。 すべてのレコードに、出典とライセンスが記載されています。

2. 欠落が可視化されています。 上位のティアがフィールドを提供しない場合、レスポンスはその旨を明示します。どのソースも数値を公開していない場合、勝手に埋めるのではなく、説明付きでnullのままにします。

3. 判定にはメカニズムが伴います。 companion_check は、ガーデニングブログに書いてあるからといって「相性が良い」とは決して言いません。ケアデータの根拠からなぜかを説明し、根拠がまったくない場合にはその旨を明かします。

Related MCP server: nasa-exoplanet-mcp

ツール

すべてのツールはコンパクトなJSONを返します。HTMLもページダンプもありません。

companion_check は民間伝承ではなくメカニズムを返します

このサーバーのソース一覧にあるAPIは、植物の敵対関係を公開していません（Permapeopleは「コンパニオン」リンクのみを掲載）。そのため、良い/悪い/中立の回答を単純に検索することはできません。庭の言い伝えを繰り返すのではなく、否定的なケースはケアデータにすでにある根拠から導き出されます。

リスクメカニズムは肯定的な記載よりも優先されますが、上書きされたものを含め、一致したすべての理由が返されるため、混合ペアも判読可能なままです。neutral の判定は、それが相性の証拠ではなく、証拠がないことを明確に示します。

planting_window は作物のタイミングを推測しません

座標を与えると、Open-Meteoの10年分の日別最低気温から、春の最終霜の中央値、秋の初霜、季節の長さ、サイトのUSDAゾーンを導き出し、それを植物の公開された耐寒性範囲と照合します。公開されている平年値と照合済みです。

このサーバーがしないことは、作物側の情報をでっち上げることです。この一覧のソースはどれも成熟日数や耐霜性クラスを公開していないため、移植日と播種期限は、days_to_maturity と frost_tolerance を自分で指定した場合にのみ表示されます。この分割は意図的です。このサーバーは気候側を担当し、呼び出し側は作物側を担当します。

南半球のサイトは、それぞれの栽培シーズンで読み取られます。暦年でグループ化すると南半球の夏が2つに分割され、霜のない期間がおよそ1日と報告されます。

インストール

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キーがなくてもサーバーは停止しません。ツールはリストに残り、各呼び出しは設定すべき変数とキーの入手先を回答します。

ソースとその制限

これらの制約がサーバーが正直に回答できる内容を形作るため、明確に述べます。

1日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のデータはシェアアライクです。