Couchbase Model Context Protocol Server
2025.02.26
2
JavaScript语义搜索向量搜索AI 模型交互数据库内容生成
Couchbase Model Context Protocol Server 是一个基于 Couchbase 的向量搜索功能实现的 MCP 服务器，主要用于提供《星球大战》行星的语义搜索能力。该服务器允许 AI 模型通过标准化的 Model Context Protocol (MCP) 与外部工具和数据源交互，实现行星信息的获取和相似行星的查找。
View on GitHub
Overview
基本能力
产品定位
Couchbase-mcp 是一个结合了 Couchbase 数据库和 AI 模型交互能力的服务器，专注于提供语义搜索和向量搜索功能。
核心功能
- 行星信息获取：通过名称获取《星球大战》行星的详细信息。
- 相似行星查找：基于向量嵌入查找相似的行星。
- 高效向量搜索：利用 Couchbase 的向量搜索索引进行快速相似性查询。
- 超时保护：为搜索和文档获取操作设置超时。
- 连接管理：妥善管理 Couchbase 连接并进行清理。
- 错误处理：全面的错误处理和调试支持。
- 类型安全：完整的 TypeScript 实现，包含适当的类型定义。
适用场景
- AI 模型需要获取《星球大战》行星的详细信息。
- AI 模型需要查找与特定行星相似的其他行星。
- 需要高效、快速的向量搜索功能的应用场景。
工具列表
- fetch_planet_name：通过名称获取行星详细信息。
- find_planets_which_are_similar：查找与给定名称相似的行星。
常见问题解答
- 如何设置环境变量？：确保设置
COUCHBASE_URL、COUCHBASE_USERNAME、COUCHBASE_PASSWORD、COUCHBASE_BUCKET、COUCHBASE_SCOPE和COUCHBASE_COLLECTION环境变量。 - 如何创建向量搜索索引？：在 Couchbase 中创建一个名为
vector-search-index的索引，索引embedding字段。
使用教程
使用依赖
- 安装 Node.js。
- 安装具有向量搜索功能的 Couchbase Server。
- 设置环境变量：
bash export COUCHBASE_URL=<your_couchbase_url> export COUCHBASE_USERNAME=<your_username> export COUCHBASE_PASSWORD=<your_password> export COUCHBASE_BUCKET=<your_bucket> export COUCHBASE_SCOPE=<your_scope> export COUCHBASE_COLLECTION=<your_collection>
安装教程
- 克隆项目仓库。
- 安装依赖：
bash npm install - 启动服务器：
bash npm start
调试方式
- 确保所有环境变量已正确设置。
- 检查 Couchbase 连接是否正常。
- 使用示例查询测试服务器功能：
json { "name": "fetch_planet_name", "arguments": { "name": "Tatooine" } }json { "name": "find_planets_which_are_similar", "arguments": { "name": "Tatooine" } }