
couchdb-mcp-server

2025.03.02
2
JavaScript数据库管理CouchDB交互数据库
couchdb-mcp-server是一个基于TypeScript的MCP服务器,专为与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及以上版本并需要Mango查询功能的项目
工具列表
- 基础工具
createDatabase
: 创建新数据库listDatabases
: 列出所有数据库deleteDatabase
: 删除指定数据库createDocument
: 创建或更新文档-
getDocument
: 获取指定文档 -
Mango查询工具
createMangoIndex
: 创建新的Mango索引deleteMangoIndex
: 删除现有的Mango索引listMangoIndexes
: 列出数据库中的所有Mango索引findDocuments
: 使用Mango查询语法查询文档
常见问题解答
- 错误处理: 服务器包含对常见场景的健壮错误处理,如无效的数据库名称或文档ID、数据库已存在/不存在、连接问题、认证失败和无效的文档数据。
- 调试: 由于MCP服务器通过stdio通信,调试可能具有挑战性。推荐使用MCP Inspector进行调试。
使用教程
使用依赖
- Node.js 14或更高版本
- 运行的CouchDB实例
- 如果启用了认证,需要正确的CouchDB凭证
安装教程
- 通过Smithery安装:
npx -y @smithery/cli install @robertoamoreno/couchdb-mcp-server --client claude
- 为Claude Desktop添加服务器配置:
{
"mcpServers": {
"couchdb-mcp-server": {
"command": "/path/to/couchdb-mcp-server/build/index.js",
"env": {
"COUCHDB_URL": "http://username:password@localhost:5984"
}
}
}
}
- 安装依赖:
npm install
- 构建服务器:
npm run build
调试方式
使用MCP Inspector进行调试:
npm run inspector
许可证
None