Biodiversity Model Context Protocol Server

Provides a Biodiversity MCP server with local and development run options for Windows, including auto-reload and uvicorn support.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mikkohei13-mcp-biodiversity": {
      "command": "mcp",
      "args": [
        "run",
        "server.py"
      ]
    }
  }
}

You run a Biodiversity Model Context Protocol (MCP) server locally to explore, test, and deploy model context interactions. This server lets you host the biodiversity context endpoints and connect to an MCP client for experimentation, development, and integration with your ecosystem.

How to use

You can start the server in several ways depending on your workflow. Use the standard runtime for quick testing, use a development flow for auto-reload during iterations, or run a lightweight dev server for rapid prototyping. Each method launches the server so your MCP client can send requests and receive model context results.

How to install

Prerequisites on Windows before you start: install Python with the official installer and ensure it is added to your PATH. Install the UDP library tool you will use for MCP workflows using the provided PowerShell script. Activate a virtual environment, then install and run the server as described.

# Install Python from the official installer and ensure PATH is set

# Install uv using the provided script (avoids PATH issues from pip)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" 

# Activate the virtual environment
.venv\Scripts\activate

# Install the server for Claude Desktop (if you need this variant)
mcp install server.py

# Run the server normally
mcp run server.py

# Run the server with auto-reload (development mode)
python -m uvicorn server:mcp --reload

# Development server and Inspector (Node & npx required)
mcp dev server.py

# Check running MCP processes
Get-Process | Where-Object { $_.ProcessName -like "*mcp*" }

# Stop running MCP processes
Get-Process | Where-Object { $_.ProcessName -like "*mcp*" } | Stop-Process -Force

How to install

Follow these concrete steps to set up the server from scratch on Windows. The commands are shown exactly as you type them.

# 1) Install Python (with PATH) and ensure Python is available in your shell
# 2) Install uv via the provided script (recommended over pip for PATH stability)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 3) Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate

# 4) Install/run the server for Claude Desktop (if applicable)
mcp install server.py

# 5) Start the server in standard mode
mcp run server.py

# 6) Start a development server with auto-reload
python -m uvicorn server:mcp --reload

# 7) Optional development workflow with MCP dev flow (requires Node & npx)
mcp dev server.py

Additional notes

If you need to stop all MCP-related processes at any time, use the provided commands to list and terminate them. Keep an eye on the active processes to avoid conflicts with other tools.

# List MCP processes
Get-Process | Where-Object { $_.ProcessName -like "*mcp*" }

# Stop MCP processes forcefully
Get-Process | Where-Object { $_.ProcessName -like "*mcp*" } | Stop-Process -Force