Qdrant

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

本指南将详细介绍如何安装、配置和使用 mcp-server-qdrant 服务器，帮助你快速搭建并运行 MCP 服务。

🚀 快速开始

安装

安装 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

设置项目文件

.env 文件

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

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

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 中定义的服务器。

测试

使用 MCP 检查

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

mcp inspect

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

手动测试

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

npm start

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

🤝 贡献

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

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