What is Minds Mcp

Minds-MCP is an MCP (Model Context Protocol) server designed for Minds, enabling Large Language Models (LLMs) to interact with the Minds SDK through a standardized interface.

Use cases

Use cases for Minds-MCP include generating responses in conversational AI applications, integrating LLMs with the Minds SDK for enhanced functionality, and creating custom AI solutions that leverage the capabilities of Minds.

How to use

To use Minds-MCP, first install the required dependencies in a virtual environment. Configure the server using environment variables, then start the server with the command ‘python -m server’. You can interact with the server using resource and tool templates provided in the documentation.

Key features

Key features of Minds-MCP include standardized resource templates for data retrieval, customizable server settings via environment variables, and support for generating completions using specified Minds.

Where to use

Minds-MCP can be used in various fields where interaction with Large Language Models is required, such as AI development, chatbot creation, and data processing applications.

Minds MCP Server

An MCP (Model Context Protocol) server for Minds, allowing LLMs to interact with the Minds SDK through a standardized interface.

Installation

Install the required dependencies (virtual environment recommended)

python -m venv env
source env/bin/activate

pip install -r requirements.txt
pip install -r requirements-dev.txt

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

• MINDS_BASE_URL: Base URL for the Minds API (default: https://mdb.ai)

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:

1. Discover available resource and tool templates
2. Instantiate templates with parameters
3. Access resources and call tools in a standardized way