使用说明

项目简介

MindsDB 是一个开源 AI 平台，它不仅是一个强大的 AI 应用构建解决方案，更可以作为 Model Context Protocol (MCP) 服务器。MindsDB 旨在桥接大型语言模型 (LLM) 与各种企业数据源，包括数据库、数据仓库和 SaaS 应用，从而使 AI 应用能够安全、可扩展地访问和利用这些数据。

主要功能点

• 数据集成: 连接多种数据源，包括传统数据库、云端数据仓库和 SaaS 应用。
• 知识库 (Knowledge Bases): 构建基于 RAG (Retrieval-Augmented Generation) 技术的知识库，从任意数据源中提取信息，支持结构化和非结构化数据。
• SQL 接口: 使用标准 SQL 查询语言进行数据操作和 AI 应用构建，简化 AI 应用开发流程。
• MCP 服务器: 作为 MCP 服务器，标准化地向 LLM 客户端提供上下文信息和功能，支持资源管理、工具注册和 Prompt 模板定义。
• 灵活部署: 支持多种部署方式，包括 Docker、Docker Desktop 和 PyPI，可部署在本地、云端等多种环境。

安装步骤

推荐使用 Docker Desktop 快速安装 MindsDB 服务器：

1. 安装 Docker Desktop: 访问 Docker Desktop 官网 下载并安装 Docker Desktop。
2. 拉取 MindsDB Docker 镜像: 打开终端或命令提示符，运行以下命令拉取 MindsDB Docker 镜像：

   docker pull mindsdb/mindsdb
   

3. 运行 MindsDB 服务器: 运行以下命令启动 MindsDB 服务器：

   docker run -p 47334:47334 -v mindsdb_data:/mindsdb_data mindsdb/mindsdb
   

   这将启动 MindsDB 服务器，并通过 47334 端口对外提供服务。

服务器配置 (MCP 客户端)

MCP 客户端需要配置以下信息以连接 MindsDB MCP 服务器。以下是一个 JSON 格式的配置示例：

{
  "serverName": "mindsdb_mcp_server",  // MCP 服务器名称，可自定义
  "command": "MindsDB",              // MCP 服务器启动命令，此处填写 MindsDB
  "args": [                         // 启动参数，MindsDB Docker 部署无需额外参数
  ],
  "transport": {                    // 通信协议配置
    "type": "websocket",            // 使用 WebSocket 协议
    "uri": "ws://127.0.0.1:47334"    // WebSocket 连接 URI，指向 MindsDB 服务器地址
  }
}

基本使用方法

1. 连接数据源: 使用 SQL 命令连接各种数据源，例如 PostgreSQL 数据库：

   CREATE DATABASE demo_postgres_db
   WITH ENGINE = "postgres",
   PARAMETERS = {
     "user": "demo_user",
     "password": "demo_password",
     "host": "samples.mindsdb.com",
     "port": "5432",
     "database": "demo",
     "schema": "demo_data"
   };
   

2. 创建知识库: 创建知识库并加载数据，例如从 Amazon 评论数据创建知识库：

   CREATE KNOWLEDGE_BASE mindsdb.reviews_kb;
   
   INSERT INTO mindsdb.reviews_kb (
     SELECT review as content FROM demo_pg_db.amazon_reviews
   );
   

3. 查询知识库: 使用 SQL 查询知识库，例如搜索关于 Kindle 评论的内容：

   SELECT *  FROM mindsdb.reviews_kb
   WHERE content LIKE 'what are the best kindle reviews'
   LIMIT 10;
   

4. 使用 Python SDK: 使用 MindsDB Python SDK 在应用程序中调用知识库：

   import mindsdb_sdk
   server = mindsdb_sdk.connect('http://127.0.0.1:47334')
   reviews_kb = server.knowledge_bases.get('mindsdb.reviews_kb');
   df = reviews_kb.find('what are the best kindle reviews').fetch()
   

更多详细使用方法和功能，请参考 MindsDB 官方文档。