MCP 服务器：mcp-server-qdrant 使用指南

安装

安装 Node.js 和 npm

1. 访问 Node.js 官网 下载并安装适合你操作系统的 Node.js 版本。
2. 确保已安装 npm（Node 包管理器），它是 Node.js 的一部分。

安装 MCP CLI

在终端或命令提示符中运行以下命令以全局安装 MCP CLI：

npm install mcp-cli -g

配置

创建工作区

1. 打开终端并导航到你选择的工作目录。

2. 初始化一个新的 Git 仓库（可选但推荐）：

   git init
   

3. 创建一个 package.json 文件，添加以下内容：

   {
     "name": "mcp-server-qdrant",
     "version": "1.0.0",
     "scripts": {
       "start": "mcp start mcp_server_qdrant/server.py"
     },
     "dependencies": {
       "mcp-cli": "^2.3.0"
     }
   }
   

4. 安装项目依赖：

   npm install
   

设置项目文件

1. .env 文件

创建一个 .env 文件并添加以下内容：

QDRANT_URL=http://localhost:6333
COLLECTION_NAME=mcp_demo

2. mcp_server_qdrant/server.py

创建一个新的 Python 文件 server.py 并添加以下内容：

import os
from mcp_server import server

if __name__ == "__main__":
    server.start(
        qdrant_url=os.getenv("QDRANT_URL"),
        collection_name=os.getenv("COLLECTION_NAME")
    )

启动服务

使用 npm 脚本启动

在终端中运行：

npm start

这将启动 MCP 服务器，它会在 server.py 中使用你指定的 QDrant URL 和集合名称。

直接运行 Python 脚本

如果你不想使用 npm 脚本，可以直接运行：

python mcp_server_qdrant/server.py

配置 MCP CLI

MCP CLI 是一个用于与 MCP 服务器交互的命令行工具。可以通过以下方式配置你的项目：

全局配置

编辑全局 mcp.json 文件（位于 $HOME/.config/mcp/cli/），添加以下内容：

{
  "global": {
    "servers": {
      "qdrant": {
        "command": "npm",
        "args": ["start"],
        "env": {}
      }
    }
  }
}

工作区配置

在项目根目录下创建一个 mcp.json 文件，并添加以下内容：

{
  "servers": {
    "qdrant": {
      "command": "npm",
      "args": ["start"],
      "env": {}
    }
  }
}

使用

创建新项目

在终端中运行以下命令以创建新项目：

mcp new my_project
cd my_project

启动服务器

使用以下命令启动 MCP 服务器：

mcp start

这将启动你在 server.py 中定义的服务器。

贡献

欢迎为这个项目贡献代码！请通过以下方式参与：

1. 提交问题：在 GitHub 上报告你遇到的问题。
2. 提交功能请求：同样在 GitHub 仓库中提交新的功能请求。
3. 拉取请求：为项目修复错误或添加新功能。

测试

使用 MCP 检查

使用 MCP CLI 工具检查你的服务器：

mcp inspect

这将显示你配置的服务器状态和其他相关信息。

手动测试

在终端中运行以下命令以手动启动服务并进行测试：

npm start

然后，你可以通过访问 http://localhost:6333 查看你连接的 QDrant 服务状态。