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 镜像
• 报告问题