一个面向Minds的MCP（模型上下文协议）服务器，允许大型语言模型通过标准化接口与Minds SDK交互。

安装

安装所需的依赖（推荐使用虚拟环境）

配置

服务器可以通过环境变量进行配置：

FastMCP 设置

• FASTMCP_DEBUG：启用调试模式（默认：false）
• FASTMCP_LOG_LEVEL：设置日志级别（默认：INFO）
• FASTMCP_HOST：要绑定的主机（默认：0.0.0.0）
• FASTMCP_PORT：绑定端口（默认：8000）
• FASTMCP_SSE_PATH：SSE事件路径（默认：/sse）
• FASTMCP_MESSAGE_PATH：消息路径（默认：/messages/）

心灵设定

• MINDS_BASE_URL：Minds API 的基础 URL（默认：https://mdb.ai)

用途

启动服务器

资源模板

服务器根据MCP规范暴露以下资源模板：

• minds://{api_key} - 列出所有可用的心灵
• minds://{mind_name}/{api_key} - 按名字获取特定的心灵

工具模板

服务器提供以下工具模板：

• completion - 使用指定的心智生成完备
• 参数：
• mind_name：心智的ID，用于使用

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