couchdb-mcp-server

couchdb-mcp-server

site icon
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查询功能的项目

工具列表

  1. 基础工具
  2. createDatabase: 创建新数据库
  3. listDatabases: 列出所有数据库
  4. deleteDatabase: 删除指定数据库
  5. createDocument: 创建或更新文档
  6. getDocument: 获取指定文档

  7. Mango查询工具

  8. createMangoIndex: 创建新的Mango索引
  9. deleteMangoIndex: 删除现有的Mango索引
  10. listMangoIndexes: 列出数据库中的所有Mango索引
  11. findDocuments: 使用Mango查询语法查询文档

常见问题解答

  • 错误处理: 服务器包含对常见场景的健壮错误处理,如无效的数据库名称或文档ID、数据库已存在/不存在、连接问题、认证失败和无效的文档数据。
  • 调试: 由于MCP服务器通过stdio通信,调试可能具有挑战性。推荐使用MCP Inspector进行调试。

使用教程

使用依赖

  • Node.js 14或更高版本
  • 运行的CouchDB实例
  • 如果启用了认证,需要正确的CouchDB凭证

安装教程

  1. 通过Smithery安装:
npx -y @smithery/cli install @robertoamoreno/couchdb-mcp-server --client claude
  1. 为Claude Desktop添加服务器配置:
{
  "mcpServers": {
    "couchdb-mcp-server": {
      "command": "/path/to/couchdb-mcp-server/build/index.js",
      "env": {
        "COUCHDB_URL": "http://username:password@localhost:5984"
      }
    }
  }
}
  1. 安装依赖:
npm install
  1. 构建服务器:
npm run build

调试方式

使用MCP Inspector进行调试:

npm run inspector

许可证

None