Minds MCP Server

用于Minds的MCP（模型上下文协议）服务器，允许LLMs通过标准化接口与Minds SDK进行交互。

安装

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

python -m venv env
source env/bin/activate

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

配置

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

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 设置

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

使用

启动服务器

python -m server

资源模板

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

• minds://{api_key} - 列出所有可用的Minds
• minds://{mind_name}/{api_key} - 根据名称获取特定的Mind

工具模板

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

• completion - 使用指定的Mind生成完成内容
  • 参数：
    • mind_name: 要使用的Mind的ID
    • message: 要完成的消息
    • api_key: Minds API密钥

开发

运行测试

# 运行所有测试
python -m pytest

# 只运行单元测试
python -m pytest tests/unit

开发模式

为了更方便地开发，可以使用MCP开发服务器：

mcp dev server.py

这将启动服务器并在浏览器中打开MCP Inspector以供测试。

MCP协议

此服务器实现了模型上下文协议（MCP），它提供了：

• 资源模板：用于检索数据的参数化URL模式
• 工具模板：执行操作的功能签名
• 提示模板：可重用的交互模板（本服务器未使用）

MCP客户端可以：

1. 发现可用的资源和工具模板
2. 使用参数实例化模板
3. 以标准化方式访问资源并调用工具