Madhukarkumar Singlestore MCP Server

🚀 SingleStore MCP サーバー

SingleStoreデータベースのモデルコンテキストプロトコル（MCP）サーバーで、安全なやり取りをサポートします。このサーバーにより、AIアシスタントはテーブルを一覧表示し、データを読み取り、制御されたインターフェイスを通じてSQLクエリを実行できるため、データベースの探索と分析を安全かつ構造化された形で行うことができます。

✨ 主な機能

• 利用可能なSingleStoreテーブルをリソースとして一覧表示
• BSONやJSONなどの複数の形式でメッセージ内容を読み取り
• エラー処理機能付きでSQLクエリを実行
• SingleStore固有のデータ型と関数をサポート
• 環境変数を通じてデータベースアクセスの安全性を実現
• 包括的なロギング

📦 インストール

pip install singlestore-mcp-server

🛠️ 設定

以下の環境変数を設定します。

SINGLESTORE_HOST=your_workspace_host
SINGLESTORE_PORT=3306  # SingleStoreのデフォルトポート
SINGLESTORE_USER=your_username
SINGLESTORE_PASSWORD=your_password
SINGLESTORE_DATABASE=your_database

💻 使用例

Claude Desktopでの使用

以下の内容を claude_desktop_config.json ファイルに追加します。

{
  "mcpServers": {
    "singlestore": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/singlestore_mcp_server",
        "run",
        "singlestore_mcp_server"
      ],
      "env": {
        "SINGLESTORE_HOST": "your_workspace_host",
        "SINGLESTORE_PORT": "3306",
        "SINGLESTORE_USER": "your_username",
        "SINGLESTORE_PASSWORD": "your_password",
        "SINGLESTORE_DATABASE": "your_database"
      }
    }
  }
}

独立したサーバーとして実行

# 依存関係をインストール
pip install -r requirements.txt

# サーバーを起動
python -m singlestore_mcp_server

🔧 開発

# リポジトリをクローン
git clone https://github.com/yourusername/singlestore_mcp_server.git
cd singlestore_mcp_server

# 仮想環境を作成
python -m venv venv
source venv/bin/activate  # または Windows では `venv\Scripts\activate`

# 開発用の依存関係をインストール
pip install -r requirements-dev.txt

# テストを実行
pytest

🎯 SingleStore固有の機能

• BSONデータ型と操作をサポート
• SingleStoreのJSON関数をサポートするネイティブJSON処理
• SingleStore Kai（MongoDB API互換性）をサポート
• SingleStore固有のデータ型を適切に処理

⚠️ セキュリティに関する注意事項

• 環境変数や認証情報を決してコミットしないでください
• 最小限の権限を持つデータベースユーザーを使用する
• 本番環境ではクエリホワイトリストを導入することを検討する
• すべてのデータベース操作を監視し、記録する

🔐 セキュリティのベストプラクティス

このMCPサーバーはデータベースアクセス権限が必要です。安全のために：

1. 専用のSingleStoreユーザーを作成し、最小限の権限を付与する
2. セキュリティ上の重要な認証情報をハードコードしないで、設定ファイルやコードに記載しない
3. 定期的にアクセスポリシーを見直し、更新して安全性を確保する
4. 監査ログを有効化してデータベースの活動を監視する

セキュリティに関する詳細な提案については、SingleStoreセキュリティガイドを参照してください。

📄 ライセンス

このプロジェクトは LICENSE ライセンスに基づいています。詳細については、関連ファイルを参照してください。

🤝 コントリビューションガイド

このプロジェクトに貢献したい場合は、CONTRIBUTING.md ファイルを参照して詳細を確認してください。改善や修正の提案を歓迎します！