Minds MCP Server
An MCP (Model Context Protocol) server for Minds, allowing LLMs to interact with the Minds SDK through a standardized interface.
Configuration
The server can be configured using environment variables:
FastMCP Settings
FASTMCP_DEBUG: Enable debug mode (default: false)
FASTMCP_LOG_LEVEL: Set log level (default: INFO)
FASTMCP_HOST: Host to bind to (default: 0.0.0.0)
FASTMCP_PORT: Port to bind to (default: 8000)
FASTMCP_SSE_PATH: Path for SSE events (default: /sse)
FASTMCP_MESSAGE_PATH: Path for messages (default: /messages/)
Minds Settings
Usage
Starting the Server
python -m server
Resource Templates
The server exposes the following resource templates according to the MCP specification:
minds://{api_key} - List all available Minds
minds://{mind_name}/{api_key} - Get a specific Mind by name
Tool Templates
The server provides the following tool templates:
completion - Generate a completion using a specified Mind
- Parameters:
mind_name: The ID of the Mind to use
message: The message to complete
api_key: The Minds API key
Development
Running Tests
# Run all tests
python -m pytest
# Run only unit tests
python -m pytest tests/unit
Development Mode
For easier development, you can use the MCP development server:
mcp dev server.py
This will start the server and open the MCP Inspector in your browser for testing.
MCP Protocol
This server implements the Model Context Protocol (MCP), which provides:
- Resource Templates: Parameterized URL patterns for retrieving data
- Tool Templates: Function signatures for executing actions
- Prompt Templates: Reusable interaction templates (not used in this server)
MCP clients can:
- Discover available resource and tool templates
- Instantiate templates with parameters
- Access resources and call tools in a standardized way