Minds MCP 服务器

一个用于 Minds 的 MCP（模型上下文协议）服务器，允许大型语言模型（LLM）通过标准化接口与 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 检查器以进行测试。

MCP 协议

该服务器实现了模型上下文协议 (MCP)，提供了：

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

MCP 客户端可以：

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