qdrant-mcp-local

qdrant-mcp-local

以下は、ローカル環境でQdrantとMCP-server-qdrantを簡単に立ち上げるためのDocker Compose設定です。 ```yaml version: "3.9" services: qdrant: image: qdrant/qdrant:latest ports: - "6333:6333" - "6334:6334" volumes: - qdrant_data:/qdrant/storage restart: unless-stopped mcp-server-qdrant: image: your-mcp-server-qdrant-image:latest # ここにあなたのMCP-server-qdrantのイメージ名を指定してください ports: - "8000:8000" # 例：MCP-server-qdrantが8000番ポートで動作する場合 environment: QDRANT_HOST: qdrant QDRANT_PORT: 6333 # その他のMCP-server-qdrantに必要な環境変数を設定 depends_on: - qdrant restart: unless-stopped volumes: qdrant_data: ``` **説明:** * **`version: "3.9"`**: Docker Composeファイルのバージョンを指定します。 * **`services`**: 起動するサービスを定義します。 * **`qdrant`**: Qdrantのサービス定義です。 * **`image: qdrant/qdrant:latest`**: 最新のQdrantイメージを使用します。 * **`ports`**: ホストマシンのポートとコンテナのポートをマッピングします。 * `6333:6333`: QdrantのgRPCポートをマッピングします。 * `6334:6334`: QdrantのHTTPポートをマッピングします。 * **`volumes`**: データを永続化するために、ホストマシンのボリュームとコンテナ内のディレクトリをマッピングします。 * `qdrant_data:/qdrant/storage`: Qdrantのデータを`qdrant_data`ボリュームに保存します。 * **`restart: unless-stopped`**: コンテナが停止した場合、自動的に再起動します。ただし、手動で停止した場合は再起動しません。 * **`mcp-server-qdrant`**: MCP-server-qdrantのサービス定義です。 * **`image: your-mcp-server-qdrant-image:latest`**: **ここにあなたのMCP-server-qdrantのDockerイメージ名を指定してください。** * **`ports`**: ホストマシンのポートとコンテナのポートをマッピングします。 * `8000:8000`: MCP-server-qdrantが8000番ポートで動作する場合の例です。必要に応じて変更してください。 * **`environment`**: MCP-server-qdrantに必要な環境変数を設定します。 * `QDRANT_HOST: qdrant`: Qdrantのホスト名を`qdrant`に設定します。Docker Composeはサービス名をホスト名として解決します。 * `QDRANT_PORT: 6333`: QdrantのgRPCポートを6333に設定します。 * **その他の環境変数**: MCP-server-qdrantに必要なその他の環境変数を設定してください。例えば、APIキーや認証情報などです。 * **`depends_on`**: `qdrant`サービスが起動してから`mcp-server-qdrant`サービスを起動するように依存関係を設定します。 * **`restart: unless-stopped`**: コンテナが停止した場合、自動的に再起動します。ただし、手動で停止した場合は再起動しません。 * **`volumes`**: ボリュームを定義します。 * **`qdrant_data`**: Qdrantのデータを保存するためのボリュームです。 **使い方:** 1. 上記のYAMLコードを`docker-compose.yml`という名前で保存します。 2. `your-mcp-server-qdrant-image:latest`をあなたのMCP-server-qdrantのDockerイメージ名に置き換えてください。 3. MCP-server-qdrantに必要な環境変数を`environment`セクションに追加してください。 4. ターミナルで`docker-compose.yml`ファイルがあるディレクトリに移動し、次のコマンドを実行します。 ```bash docker-compose up -d ``` これにより、QdrantとMCP-server-qdrantがバックグラウンドで起動します。 5. サービスが起動していることを確認するには、次のコマンドを実行します。 ```bash docker-compose ps ``` **注意点:** * この設定は、ローカル環境での開発およびテストを目的としています。本番環境で使用する場合は、セキュリティやパフォーマンスに関する考慮事項を追加する必要があります。 * `your-mcp-server-qdrant-image:latest`をあなたのMCP-server-qdrantのDockerイメージ名に置き換えることを忘れないでください。 * MCP-server-qdrantに必要な環境変数を`environment`セクションに追加してください。 * 必要に応じて、ポートマッピングやボリュームマッピングを調整してください。 **中国語訳:** 以下是一个用于在本地环境中轻松启动 Qdrant 和 MCP-server-qdrant 的 Docker Compose 配置： ```yaml version: "3.9" services: qdrant: image: qdrant/qdrant:latest ports: - "6333:6333" - "6334:6334" volumes: - qdrant_data:/qdrant/storage restart: unless-stopped mcp-server-qdrant: image: your-mcp-server-qdrant-image:latest # 请在此处指定您的 MCP-server-qdrant 镜像名称 ports: - "8000:8000" # 示例：如果 MCP-server-qdrant 在 8000 端口上运行 environment: QDRANT_HOST: qdrant QDRANT_PORT: 6333 # 设置 MCP-server-qdrant 所需的其他环境变量 depends_on: - qdrant restart: unless-stopped volumes: qdrant_data: ``` **说明:** * **`version: "3.9"`**: 指定 Docker Compose 文件的版本。 * **`services`**: 定义要启动的服务。 * **`qdrant`**: Qdrant 的服务定义。 * **`image: qdrant/qdrant:latest`**: 使用最新的 Qdrant 镜像。 * **`ports`**: 将主机端口映射到容器端口。 * `6333:6333`: 映射 Qdrant 的 gRPC 端口。 * `6334:6334`: 映射 Qdrant 的 HTTP 端口。 * **`volumes`**: 为了持久化数据，将主机卷映射到容器内的目录。 * `qdrant_data:/qdrant/storage`: 将 Qdrant 数据保存到 `qdrant_data` 卷中。 * **`restart: unless-stopped`**: 如果容器停止，则自动重启。但是，如果手动停止，则不会重启。 * **`mcp-server-qdrant`**: MCP-server-qdrant 的服务定义。 * **`image: your-mcp-server-qdrant-image:latest`**: **请在此处指定您的 MCP-server-qdrant 的 Docker 镜像名称。** * **`ports`**: 将主机端口映射到容器端口。 * `8000:8000`: 如果 MCP-server-qdrant 在 8000 端口上运行，这是一个示例。根据需要进行更改。 * **`environment`**: 设置 MCP-server-qdrant 所需的环境变量。 * `QDRANT_HOST: qdrant`: 将 Qdrant 的主机名设置为 `qdrant`。 Docker Compose 将服务名称解析为主机名。 * `QDRANT_PORT: 6333`: 将 Qdrant 的 gRPC 端口设置为 6333。 * **其他环境变量**: 设置 MCP-server-qdrant 所需的其他环境变量。例如，API 密钥或凭据。 * **`depends_on`**: 设置依赖关系，以便在 `qdrant` 服务启动后启动 `mcp-server-qdrant` 服务。 * **`restart: unless-stopped`**: 如果容器停止，则自动重启。但是，如果手动停止，则不会重启。 * **`volumes`**: 定义卷。 * **`qdrant_data`**: 用于存储 Qdrant 数据的卷。 **用法:** 1. 将上述 YAML 代码保存为 `docker-compose.yml`。 2. 将 `your-mcp-server-qdrant-image:latest` 替换为您的 MCP-server-qdrant 的 Docker 镜像名称。 3. 将 MCP-server-qdrant 所需的环境变量添加到 `environment` 部分。 4. 在终端中，导航到包含 `docker-compose.yml` 文件的目录，然后运行以下命令： ```bash docker-compose up -d ``` 这将启动 Qdrant 和 MCP-server-qdrant 在后台运行。 5. 要验证服务是否正在运行，请运行以下命令： ```bash docker-compose ps ``` **注意事项:** * 此配置旨在用于本地环境中的开发和测试。 如果在生产环境中使用，则需要添加有关安全性和性能的注意事项。 * 不要忘记将 `your-mcp-server-qdrant-image:latest` 替换为您的 MCP-server-qdrant 的 Docker 镜像名称。 * 将 MCP-server-qdrant 所需的环境变量添加到 `environment` 部分。 * 根据需要调整端口映射和卷映射。

hirokita117

开发者工具
访问服务器

README

qdrant-mcp-local

这是一个 Docker Compose 配置，用于在本地环境中轻松启动 Qdrant 和 MCP-server-qdrant。

概述

此仓库包含以下组件：

  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
  1. 创建用于存储数据的目录：
mkdir -p data
  1. 使用 Docker Compose 启动环境（首次启动可能需要一些时间来构建）：
docker compose up -d

这将启动以下服务：

  • Qdrant: http://localhost:6333
  • MCP Server: http://localhost:8000
  1. 停止环境：
docker compose down

Qdrant 的数据存储在 ./data 目录中，因此即使停止容器，信息也会被保留。

配置的自定义

可以通过编辑 .env 文件来更改环境变量。

故障排除

容器无法启动时

  1. 运行调试脚本:
chmod +x debug.sh
./debug.sh

此脚本将显示环境的详细信息和错误详情。

  1. 手动检查日志:
docker compose logs mcp-server
  1. 重新构建容器:

要完全重新构建环境，请执行以下操作：

docker compose down
docker compose build --no-cache
docker compose up -d
  1. 常见问题和解决方案:
  • 端口冲突: 如果 6333 或 8000 端口已被使用，请在 .env 文件中指定其他端口。
  • 磁盘空间: 确保 Docker 的磁盘空间足够。
  • Docker 守护进程: 确保 Docker 守护进程正在正常运行。

有关详细的故障排除信息，请参阅 docs/USAGE.md。

使用示例

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

许可证

本项目遵循原始 Qdrant 和 MCP-server-qdrant 的许可证。

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要，从而实现与 Curri API 的交互。

官方
本地
JavaScript