MCP Rethinkdb Server

🚀 MCP RethinkDB Server

MCP RethinkDB Server 是一個基於模型上下文協議（MCP）的服務器，它提供對 RethinkDB 數據庫的只讀訪問。該服務器允許像 Claude 這樣的 AI 助手安全地查詢和探索 RethinkDB 數據，而無需擔心意外修改數據的風險。

🚀 快速開始

MCP RethinkDB Server 為 AI 助手提供了安全訪問 RethinkDB 數據庫的途徑。以下是使用該服務器的快速步驟：

1. 確保滿足 前提條件。
2. 選擇合適的 安裝方式。
3. 配置並運行服務器。
4. 通過工具進行數據查詢。

✨ 主要特性

• 只讀操作：僅允許數據讀取，不允許數據修改，確保 AI 助手使用安全。
• 四種工具可用：
  • list_databases：列出所有數據庫。
  • list_tables：列出指定數據庫中的所有表。
  • query_table：支持過濾、排序和限制的表數據查詢。
  • table_info：獲取表的元數據（主鍵、索引、文檔數量）。
• 易於集成：可輕鬆與 Claude Desktop 和其他 MCP 客戶端集成。
• 安全連接：支持用戶名/密碼認證的安全連接。
• Docker 支持：可在 Docker Hub 上獲取預構建的鏡像。

📦 安裝指南

選項 1：使用 Docker（推薦）

docker pull finn13/mcp-rethinkdb-server

# 使用默認設置運行（連接到 localhost:28015）
docker run -e RETHINKDB_HOST=host.docker.internal finn13/mcp-rethinkdb-server

# 使用自定義設置運行
docker run \
  -e RETHINKDB_HOST=your-host \
  -e RETHINKDB_PORT=28015 \
  -e RETHINKDB_USER=admin \
  -e RETHINKDB_PASSWORD=secret \
  finn13/mcp-rethinkdb-server

選項 2：從源代碼構建

# 克隆倉庫
git clone https://github.com/finn13/mcp-rethinkdb-server.git
cd mcp-rethinkdb-server

# 安裝依賴
go mod tidy

# 構建二進制文件
go build -o mcp-rethinkdb-server .

💻 使用示例

基礎用法

配置 Claude Desktop

將以下配置添加到 Claude Desktop 的配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

使用 Docker 鏡像（推薦）

{
  "mcpServers": {
    "rethinkdb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "RETHINKDB_HOST=host.docker.internal",
        "finn13/mcp-rethinkdb-server"
      ]
    }
  }
}

使用本地二進制文件

{
  "mcpServers": {
    "rethinkdb": {
      "command": "/absolute/path/to/mcp-rethinkdb-server",
      "env": {
        "RETHINKDB_HOST": "localhost",
        "RETHINKDB_PORT": "28015"
      }
    }
  }
}

重要提示：更新配置後，請完全重啟 Claude Desktop。

直接運行

# 默認連接（localhost:28015）
./mcp-rethinkdb-server

# 自定義主機/端口
RETHINKDB_HOST=myhost RETHINKDB_PORT=28015 ./mcp-rethinkdb-server

# 使用認證
RETHINKDB_HOST=myhost RETHINKDB_USER=admin RETHINKDB_PASSWORD=secret ./mcp-rethinkdb-server

高級用法

list_databases

列出 RethinkDB 中的所有數據庫。

{
  "name": "list_databases"
}

響應示例：

{
  "databases": ["test", "production", "analytics"]
}

list_tables

列出指定數據庫中的所有表。

{
  "name": "list_tables",
  "arguments": {
    "database": "test"
  }
}

響應示例：

{
  "database": "test",
  "tables": ["users", "orders", "products"]
}

query_table

從表中查詢數據，支持可選的過濾、排序和限制。

{
  "name": "query_table",
  "arguments": {
    "database": "test",
    "table": "users",
    "filter": {"status": "active"},
    "limit": 50,
    "order_by": "created_at"
  }
}

響應示例：

{
  "database": "test",
  "table": "users",
  "count": 50,
  "results": [...]
}

參數說明：

• database（必需）：數據庫名稱。
• table（必需）：表名稱。
• filter（可選）：用於匹配文檔的過濾對象。
• limit（可選）：最大結果數（默認：100，最大：1000）。
• order_by（可選）：排序字段。

table_info

獲取表的元數據，包括主鍵、索引和文檔數量。

{
  "name": "table_info",
  "arguments": {
    "database": "test",
    "table": "users"
  }
}

響應示例：

{
  "database": "test",
  "table": "users",
  "primary_key": "id",
  "indexes": ["email", "created_at"],
  "doc_count": 15420
}

📚 詳細文檔

前提條件

• Go 1.23 或更高版本 - 下載 Go（用於從源代碼構建）
• RethinkDB：運行中的實例（本地或遠程）
  • RethinkDB 安裝指南
  • 默認連接：localhost:28015
• MCP 客戶端（測試可選）：
  • Claude Desktop 應用程序，或
  • MCP Inspector：npx @modelcontextprotocol/inspector

開發

使用 MCP Inspector 進行測試

MCP Inspector 提供了一個基於 Web 的界面來測試服務器：

go build -o mcp-rethinkdb-server .
npx @modelcontextprotocol/inspector ./mcp-rethinkdb-server

打開瀏覽器訪問顯示的 URL（通常是 http://localhost:5173）以與服務器進行交互。

路線圖

未來計劃改進和添加的功能：

高級查詢支持

• [ ] 連接操作：支持 eqJoin、innerJoin、outerJoin 操作。
• [ ] 聚合操作：添加 group、ungroup、count、sum、avg、min、max 操作。
• [ ] Map/Reduce：支持 map、concatMap、fold 進行復雜轉換。
• [ ] 高級過濾：支持 between、contains、嵌套字段查詢。
• [ ] 地理空間查詢：支持 getIntersecting 和地理空間索引。

附加工具

• [ ] 模式檢查器：用於探索表模式和關係的工具。
• [ ] 索引管理：查看和分析索引使用情況和性能。
• [ ] 查詢構建器：交互式查詢構建並進行驗證。
• [ ] 變更反饋：即時數據監控（只讀訂閱）。

性能與特性

• [ ] 查詢緩存：緩存頻繁訪問的查詢。
• [ ] 並行查詢：支持多個併發查詢。
• [ ] 結果流式傳輸：高效流式傳輸大型結果集。
• [ ] 查詢統計：執行時間和資源使用指標。

開發者體驗

• [ ] 交互式示例：更全面的示例查詢。
• [ ] 查詢驗證：更好的錯誤消息和查詢語法驗證。
• [ ] 連接池：改進連接管理。
• [ ] TLS/SSL 支持：與 RethinkDB 的安全連接。

故障排除

連接問題

問題：服務器無法連接到 RethinkDB。 解決方案：

• 驗證 RethinkDB 是否正在運行：rethinkdb --version。
• 檢查主機和端口設置。
• 手動測試連接。

Claude Desktop 集成問題

問題：服務器未在 Claude 中顯示。 解決方案：

• 驗證配置中的路徑或 Docker 命令是否正確。
• 完全重啟 Claude Desktop。
• 檢查 Claude 日誌：~/Library/Logs/Claude/（macOS）。

問題：執行二進制文件時權限被拒絕。 解決方案：

chmod +x /path/to/mcp-rethinkdb-server

查詢限制問題

問題：查詢返回的結果少於預期。 解決方案：

• 默認限制為 100 個文檔。
• 最大限制為 1000 個文檔。
• 使用 limit 參數進行調整。

貢獻

歡迎貢獻代碼！請按照以下步驟進行：

1. 分叉倉庫。
2. 創建功能分支：git checkout -b feature-name。
3. 進行更改。
4. 運行測試：go test ./...。
5. 提交：git commit -am 'Add feature'。
6. 推送：git push origin feature-name。
7. 創建拉取請求。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

🔗 鏈接

• 模型上下文協議文檔
• RethinkDB 文檔
• Docker Hub 鏡像
• 報告問題