Qdrant MCP Local

🚀 qdrant-mcp-local

本項目提供了一個Docker Compose配置，可幫助你在本地環境中輕鬆啟動Qdrant和MCP-server-qdrant。通過簡單的步驟，你就能快速搭建起向量搜索和模型上下文協議服務。

🚀 快速開始

先決條件

• Docker
• Docker Compose V2（通常已包含在Docker中）

使用方法

1. 克隆倉庫：

git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local

2. 創建數據存儲目錄：

mkdir -p data

3. 使用Docker Compose啟動環境（首次構建可能需要一點時間）：

docker compose up -d

這將啟動以下服務：

• Qdrant: http://localhost:6333
• MCP Server: http://localhost:8000

4. 停止環境：

docker compose down

Qdrant的數據存儲在./data目錄中，因此即使容器停止，信息也會保留。

✨ 主要特性

此倉庫包含以下組件：

1. Qdrant - 向量搜索引擎
2. MCP-server-qdrant - 模型上下文協議（MCP）服務器。支持與Qdrant向量數據庫的集成。

📦 安裝指南

先決條件

• Docker
• Docker Compose V2（通常已包含在Docker中）

使用方法

1. 倉庫克隆：

git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local

2. 數據存儲目錄創建：

mkdir -p data

3. 使用Docker Compose啟動環境（首次構建可能需要一點時間）：

docker compose up -d

這將啟動以下服務：

• Qdrant: http://localhost:6333
• MCP Server: http://localhost:8000

4. 環境停止：

docker compose down

Qdrant的數據存儲在./data目錄中，因此即使容器停止，信息也會保留。

設置的自定義

通過編輯.env文件可以修改環境變量。

💻 使用示例

MCP服務器的端點

• MCP SSE端點: http://localhost:8000/sse

在Claude Desktop中的設置示例

在Claude Desktop中使用時，將以下內容添加到claude_desktop_config.json：

{
  "mcpServers": {
    "qdrant": {
      "command": "curl",
      "args": ["-N", "http://localhost:8000/sse"],
      "transport": "sse"
    }
  }
}

在Cursor中的設置示例

在Cursor中使用時，在MCP服務器設置中指定以下URL：

http://localhost:8000/sse

🔧 技術細節

故障排除

容器無法啟動時

1. 運行調試腳本：

chmod +x debug.sh
./debug.sh

該腳本將顯示環境詳細信息和錯誤細節。 2. 手動查看日誌：

docker compose logs mcp-server

3. 重新構建容器： 要完全重新構建：

docker compose down
docker compose build --no-cache
docker compose up -d

4. 常見問題與解決方案：

• 端口衝突：如果6333或8000端口已被佔用，請在.env文件中指定其他端口。
• 磁盤空間：確保Docker使用的磁盤空間充足。
• Docker守護進程：確認Docker守護程序正常運行。

有關詳細故障排除信息，請參閱docs/USAGE.md。

📄 許可證

此項目遵循原始的Qdrant和MCP-server-qdrant許可。