Skip to main content
Glama

plantnet-mcp

CI Python 3.11+ License: MIT

A computer-vision botanical identification Model Context Protocol (MCP) server powered by the Pl@ntNet API v2.

Enables AI agents to identify plant species from photographs (both remote URLs and local image file paths), with multi-organ support (flower, leaf, fruit, bark), regional floras, and cross-linking to GBIF and Kew's Plants of the World Online (POWO).


Key Features

  • Local & Remote Image Ingestion: Supports public image URLs as well as direct local image files on disk via multipart upload.

  • Botanical Provenance & Native Range Verification: Checks whether an identified species is native, introduced, or exotic in the user's geographic region.

  • Multi-Organ Identification: Submit multiple complementary views of the same plant (e.g. leaf + flower + habit) to maximize identification accuracy.

  • Regional Flora Scope: Target specific continental floras (weurope, namerica, tropical-africa, mediterranean, caribbean) or use the default k-world-flora.

  • Cross-Platform Botanical Linking: Returns matched species with accepted scientific names, common names, confidence scores, and direct identifiers for GBIF and POWO.

  • Graceful Fallback Mode: Functions in reference demo mode when an API key is not present, making it easy to test and evaluate locally.


Related MCP server: chronoverify-mcp

Available Tools

Tool

Description

identify_plant_image

Identify a plant from a single image URL or local photo file path with optional provenance check.

identify_plant_batch

Identify a plant using 1 to 5 images and organ tags (flower, leaf, fruit, bark, habit).

verify_plant_provenance

Verify whether an identified plant species is native or introduced in a target region.

list_supported_projects

List available geographic and thematic flora identification projects.

get_supported_organs

List accepted botanical organ types with identification accuracy guidance.

search_project_species

Search registered botanical species in a regional flora project.


Installation & Usage

Running with uvx (Recommended)

# With Pl@ntNet API Key
PLANTNET_API_KEY=your_key_here uvx --from git+https://github.com/thesven/plantnet-mcp.git plantnet-mcp

# Or in offline reference mode
uvx --from git+https://github.com/thesven/plantnet-mcp.git plantnet-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "plantnet": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/thesven/plantnet-mcp.git", "plantnet-mcp"],
      "env": {
        "PLANTNET_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development & Quality Gate

# Run code formatting check
uv run ruff format --check src tests scripts

# Run linting
uv run ruff check src tests scripts

# Run test suite with strict coverage floor (>90%)
uv run pytest --cov=plantnet_mcp --cov-branch --cov-report=term-missing

# Build wheel and sdist
uv build

# Run package distribution check & smoke test
uv run python scripts/check_dist.py
uv run python scripts/smoke.py

License

MIT License. See LICENSE for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to query and retrieve biodiversity data from the Global Biodiversity Information Facility (GBIF), including species, occurrences, datasets, and literature.
      58
      92 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides MCP-compatible AI agents with a verify_image tool to check a photo's capture time and provenance using C2PA, EXIF, XMP metadata, and pixel forensics, returning a verdict and confidence score.
      1
      59 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying a global plant database with over 1 million species, providing access to plant records and species search via natural language.
      83 npm
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Identifies plants from photos and determines whether a species is native, introduced, or invasive in a given country, drawing on GBIF, GRIIS, and GISD data, and also provides management recommendations and country alien-species lists.
      4
      -