
couchdb-mcp-server

2025.03.24
0
JavaScript数据库管理CouchDB 交互数据库
couchdb-mcp-server 是一个基于 TypeScript 的 Model Context Protocol 服务器,专门用于与 CouchDB 数据库进行交互。它提供了一系列工具,使 AI 助手能够通过简单的接口管理 CouchDB 数据库和文档。该服务器支持基本的数据库和文档操作,以及针对 CouchDB 3.x+ 版本的 Mango 查询功能。
View on GitHub
Overview
基本能力
产品定位
couchdb-mcp-server 是一个专门用于与 CouchDB 数据库交互的 MCP 服务器,旨在简化 AI 助手对 CouchDB 的操作。
核心功能
- 基础工具(所有 CouchDB 版本)
createDatabase
: 创建新数据库listDatabases
: 列出所有数据库deleteDatabase
: 删除数据库createDocument
: 创建或更新文档-
getDocument
: 获取文档 -
Mango 查询工具(仅限 CouchDB 3.x+)
createMangoIndex
: 创建 Mango 索引deleteMangoIndex
: 删除 Mango 索引listMangoIndexes
: 列出所有 Mango 索引findDocuments
: 使用 Mango 查询文档
适用场景
- AI 助手需要与 CouchDB 数据库交互的场景
- 需要自动化管理 CouchDB 数据库和文档的项目
- 需要执行复杂查询的 CouchDB 3.x+ 环境
工具列表
- 基础工具
createDatabase
: 创建新数据库listDatabases
: 列出所有数据库deleteDatabase
: 删除数据库createDocument
: 创建或更新文档-
getDocument
: 获取文档 -
Mango 查询工具
createMangoIndex
: 创建 Mango 索引deleteMangoIndex
: 删除 Mango 索引listMangoIndexes
: 列出所有 Mango 索引findDocuments
: 使用 Mango 查询文档
常见问题解答
- 错误处理包括:无效的数据库名称或文档 ID、数据库已存在/不存在、连接问题、认证失败、无效的文档数据等。
- 所有错误都通过 MCP 协议返回,包含适当的错误代码和消息。
使用教程
使用依赖
- Node.js 14 或更高版本
- 运行的 CouchDB 实例
- 如果启用了认证,需要正确的 CouchDB 凭证
安装教程
- 通过 Smithery 安装:
npx -y @smithery/cli install @robertoamoreno/couchdb-mcp-server --client claude
- 手动安装:
npm install
npm run build
- 开发模式(自动重建):
npm run watch
调试方式
使用 MCP Inspector 进行调试:
npm run inspector
Inspector 将提供一个 URL,用于在浏览器中访问调试工具。
许可证
None