MCP Rethinkdb Server

🚀 MCP RethinkDB Server

Model Context Protocol (MCP) サーバーで、RethinkDB データベースへの読み取り専用アクセスを提供します。このサーバーにより、Claude などの AI アシスタントが誤ってデータを変更するリスクなしに、安全に RethinkDB データをクエリして探索できます。

🚀 クイックスタート

この MCP RethinkDB サーバーを使用することで、AI アシスタントが安全に RethinkDB データベースをクエリできます。以下のセクションでは、インストール方法、設定、使用例などを説明します。

✨ 主な機能

• 読み取り専用操作：データの読み取りのみを許可し、変更は行えません。AI アシスタントにとって安全です。
• 4つのツール利用可能：
  • 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
}

高度な使用法

開発

MCP Inspector でテスト

MCP Inspector は、サーバーをテストするためのウェブベースのインターフェースを提供します。

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、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 ファイルを参照してください。

リンク

• Model Context Protocol ドキュメント
• RethinkDB ドキュメント
• Docker Hub イメージ
• 問題の報告