Qdrant

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

本指南詳細介紹了 MCP 服務器 mcp-server-qdrant 的安裝、配置、啟動、使用、貢獻和測試等方面，幫助你快速上手該服務器。

🚀 快速開始

若要快速使用 MCP 服務器 mcp-server-qdrant，需按以下步驟操作：

1. 安裝 Node.js 和 npm。
2. 安裝 MCP CLI。
3. 進行項目配置，包括創建工作區和設置項目文件。
4. 啟動服務。
5. 配置 MCP CLI。
6. 開始使用服務器。

📦 安裝指南

安裝 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 服務狀態。