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	查看每日 API 使用量及配额限制（免费套餐每天可识别 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[]	是	1–5 个图像 URL（JPG 或 PNG）
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

无参数。返回当前每日使用量和配额限制。

---

限制

• 免费套餐： 每个 API 密钥每天可识别 500 次
• 每次请求最多图像数： 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