couchdb-mcp-server

couchdb-mcp-server

site icon
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 的操作。

核心功能

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

  7. Mango 查询工具(仅限 CouchDB 3.x+)

  8. createMangoIndex: 创建 Mango 索引
  9. deleteMangoIndex: 删除 Mango 索引
  10. listMangoIndexes: 列出所有 Mango 索引
  11. findDocuments: 使用 Mango 查询文档

适用场景

  • AI 助手需要与 CouchDB 数据库交互的场景
  • 需要自动化管理 CouchDB 数据库和文档的项目
  • 需要执行复杂查询的 CouchDB 3.x+ 环境

工具列表

  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 协议返回,包含适当的错误代码和消息。

使用教程

使用依赖

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

安装教程

  1. 通过 Smithery 安装:
npx -y @smithery/cli install @robertoamoreno/couchdb-mcp-server --client claude
  1. 手动安装:
npm install
npm run build
  1. 开发模式(自动重建):
npm run watch

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

Inspector 将提供一个 URL,用于在浏览器中访问调试工具。

许可证

None