Minds MCP Server

项目简介

Minds MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接 LLM 与 Minds 平台（MindsDB）。它提供了一个标准化的接口，使 AI 助手能够发现、查询并调用 Minds 平台上的各种 AI 模型（称为 "Minds"）来执行任务。

主要功能

• 获取模型列表：能够列出用户账户下所有可用的 AI 模型（Minds），包括模型的名称、提供商和参数等信息。
• 查询模型详情：根据名称获取特定 AI 模型的详细配置数据、数据源连接情况及创建更新时间。
• AI 对话补全：提供工具接口，允许 LLM 调用指定的 Mind 模型，输入提示词（Message）并获取生成的文本回复。

安装步骤

1. 环境准备：确保已安装 Python 环境。
2. 获取代码：下载或克隆本仓库到本地。
3. 安装依赖：

   # 建议使用虚拟环境
   python -m venv env
   source env/bin/activate  # Windows 使用 env\Scripts\activate
   
   # 安装项目依赖
   pip install -r requirements.txt
   

服务器配置

在支持 MCP 的客户端（如 Claude Desktop）中添加以下配置。请确保路径指向你实际存放代码的目录。

{
  "minds": {
    "command": "python",
    "args": [
      "-m",
      "server"
    ],
    "env": {
      "MINDS_BASE_URL": "https://mdb.ai",
      "FASTMCP_LOG_LEVEL": "INFO"
    }
  }
}

注意：此服务器设计为在调用工具或访问资源时动态传入 'api_key'，因此不需要在环境变量中配置 API Key。

基本使用方法

1. 启动连接：配置完成后，重启 MCP 客户端，它将自动启动该服务器。
2. 访问资源：
   • LLM 可以通过 URI 'minds://{your_api_key}' 读取所有模型列表。
   • LLM 可以通过 URI 'minds://{mind_name}/{your_api_key}' 读取特定模型详情。
3. 调用工具：
   • LLM 可以使用 'completion' 工具，提供 'mind_name'（模型名称）、'message'（提示词）和 'api_key' 来生成内容。