Plantnet Mcp

plantnet-mcp

Pl@ntNet の植物識別 API に対応する MCP サーバーです。Claude 内で写真から直接、植物を識別できます。

---

概要

plantnet-mcp は Claude を Pl@ntNet API に接続し、科学的に高精度な画像からの植物識別を可能にします。植物の写真を 1～5 枚送信すると、信頼度スコア、分類データ、地域の植物相に関する情報を含む、候補種のランキングが返されます。

提供するツール

ツール	説明
identify_plant	1～5 個の画像 URL から植物を識別します。信頼度スコア、学名・一般名、分類データ（属、科、GBIF／POWO ID）を含む候補種のランキングを返します。
list_projects	利用可能な地域別植物相データベース（例：世界、ヨーロッパ、アフリカ、アメリカ大陸）を一覧表示します。地域を指定した識別に便利です。
check_quota	1 日あたりの API 使用量を上限と照合します（無料プランでは 1 日あたり 500 件の識別が可能です）。

---

必要条件

• Node.js v18+
• 無料の Pl@ntNet API キー。my.plantnet.org で登録してください。

---

インストール

git clone https://github.com/OrHavraPerry/plantnet-mcp
cd plantnet-mcp
npm install
npm run build

---

設定

1. API キーを設定する

.env.example を .env にコピーし、キーを追加します。

cp .env.example .env

PLANTNET_API_KEY=your_api_key_here

2. Claude Desktop に追加する

Claude Desktop の設定ファイルを編集します。

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "plantnet": {
      "command": "node",
      "args": ["/absolute/path/to/plantnet-mcp/dist/index.js"],
      "env": {
        "PLANTNET_API_KEY": "your_api_key_here"
      }
    }
  }
}

保存した後、Claude Desktop を再起動してください。

---

使用例

写真の URL から植物を識別する：

Identify this plant: https://example.com/plant.jpg

精度を高めるために複数の写真で識別する：

Identify this plant using these photos — leaf: [url1], flower: [url2]

地域を指定して検索する：

List available plant projects, then identify this plant [url] using the Europe flora

API の使用状況を確認する：

How many plant identifications do I have left today?

---

ツールリファレンス

identify_plant

パラメーター	型	必須	説明
images	string[]	はい	画像 URL（JPG または PNG）1～5 個
organs	string[]	いいえ	画像ごとの植物の器官：leaf、flower、fruit、bark、habit、auto、other
project	string	いいえ	検索する植物相データベース（デフォルト：all）
lang	string	いいえ	一般名に使用する言語（デフォルト：en）
nb_results	number	いいえ	返す結果の件数。1～25 件（デフォルト：5）

list_projects

パラメーターはありません。利用可能な地域別植物相データベースをすべて返します。

check_quota

パラメーターはありません。現在の 1 日あたりの使用量と上限を返します。

---

制限

• 無料プラン： API キーごとに 1 日あたり 500 件の識別
• 1 リクエストあたりの画像の最大数： 5 枚
• 対応形式： JPG、PNG

---

開発

npm run dev      # Run with ts-node (no build needed)
npm run build    # Compile TypeScript to dist/
npm test         # Run test suite

---

ライセンス

MIT — LICENSE を参照してください