Сервер MCP (Model Context Protocol) для Minds, позволяющий LLM взаимодействовать с Minds SDK через стандартизированный интерфейс.

##Установка

Установите необходимые зависимости (рекомендуется виртуальная среда)

Конфигурация

Сервер может быть настроен с использованием переменных среды:

###Настройки FastMCP

• [[Т0]]: Включить режим отладки (по умолчанию: ложный)
• [[Т1]]: Установить уровень журнала (по умолчанию: INFO)
• [[Т2]]: Host to bind to (по умолчанию: 0.0.0.0)
• FASTMCP_PORT: Порт для связывания (по умолчанию: 8000)
• [[Т4]]: Путь к событиям SSE (по умолчанию: /sse)
• [[Т5]]: Путь для сообщений (по умолчанию: /сообщения/)

###Настройки ума

MINDS_BASE_URL: Базовый URL для API Minds (по умолчанию: https://mdb.ai))

Использование

Запуск сервера

Шаблоны ресурсов

Сервер предоставляет следующие шаблоны ресурсов в соответствии со спецификацией MCP:

[8] - Перечислите все доступные умы minds://{mind_name}/{api_key} - Получить определенный ум по имени

Шаблоны инструментов

Сервер предоставляет следующие шаблоны инструментов:

completion - Создайте завершение с помощью определенного Ума

• Параметры: [[Т11]]: Идентификатор ума для использования

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