Robertoamoreno Couchdb MCP Server

🚀 CouchDB-MCP-Server

一個用於與CouchDB交互的模型上下文協議（Model Context Protocol）服務器。它基於TypeScript構建，提供了管理CouchDB數據庫和文檔的工具，讓AI助手能通過簡單接口與CouchDB進行交互。

🚀 快速開始

這是一個基於TypeScript構建的MCP服務器，提供管理CouchDB數據庫和文檔的工具。它使AI助手能夠通過簡單的接口與CouchDB進行交互。

使用以下環境變量配置服務器：

COUCHDB_URL=http://localhost:5984
COUCHDB_VERSION=3.0.1

默認情況下，服務器會連接到本地運行的CouchDB實例。

安裝依賴

npm install

構建

npm run build

運行測試

npm test

調試

使用以下命令啟動調試工具：

npm run debug

通過Smithery安裝

在Smithery平臺使用以下命令安裝服務器：

smith install @robertoamoreno/couchdb-mcp-server

✨ 主要特性

工具

基礎工具（所有CouchDB版本）

• createDatabase - 創建新的CouchDB數據庫

  • 接受dbName作為必需參數
  • 如果數據庫不存在則創建它

• listDatabases - 列出所有CouchDB數據庫

  • 返回數據庫名稱的數組

• deleteDatabase - 刪除CouchDB數據庫

  • 接收dbName作為必需參數
  • 移除指定數據庫及其所有文檔

• createDocument - 創建新文檔或更新現有文檔

  • 必需參數：
    • dbName：數據庫名稱
    • docId：文檔ID
    • data：文檔數據（JSON對象）
      • 更新時，包含當前文檔修訂的 _rev 字段
  • 返回：
    • 新文檔：文檔ID和新修訂
    • 更新操作：文檔ID和更新後的修訂
  • 根據 _rev 字段的存在自動檢測是創建還是更新

• getDocument - 從數據庫獲取文檔

  • 必需參數：
    • dbName：數據庫名稱
    • docId：文檔ID
  • 返回文檔內容

Mango查詢工具（CouchDB 3.x及以上版本）

• createMangoIndex - 創建新的Mango索引

  • 必需參數：
    • dbName：數據庫名稱
    • indexName：索引名稱
    • fields：要索引的字段數組
  • 創建新的索引以實現高效查詢

• deleteMangoIndex - 刪除Mango索引

  • 必需參數：
    • dbName：數據庫名稱
    • designDoc：設計文檔名稱
    • indexName：索引名稱
  • 移除指定的索引

• listIndexes - 列出所有索引

  • 返回數據庫中所有索引的信息

版本支持

該服務器會根據CouchDB版本啟用不同的功能：

• 在CouchDB 2.x及以上版本上運行
• 根據檢測到的CouchDB版本自動啟用相應特性

🔧 技術細節

該服務器包含強大的錯誤處理功能，覆蓋常見場景：

• 無效的數據庫名稱或文檔ID
• 數據庫不存在或已存在
• 連接問題
• 認證失敗
• 文檔數據無效

所有錯誤都會通過MCP協議以適當的錯誤代碼和消息格式返回。