Hologres MCP Server Sse

🚀 Hologres MCP サーバー

Hologres MCP サーバーは、Model Context Protocol (MCP) に準拠したオープンソースプロジェクトです。このプロジェクトは、AI アプリケーションが Hologres データベースとやり取りできるようにすることを目的としています。SSE（Server-Sent Events）と STDIO の 2 つの伝送モードを提供し、完全なドキュメントとサンプルコードも用意されています。

🚀 クイックスタート

Hologres MCP サーバーは MCP プロトコルを実装しており、AI エージェントが Hologres データベース内のデータと機能に簡単にアクセスできるようにします。AI 駆動の IDE を構築する場合、チャットインターフェースを強化する場合、またはカスタム AI ワークフローを作成する場合でも、MCP は LLM を必要なコンテキストに接続するための標準的な方法を提供します。

📦 インストール

前提条件

• Python 3.10 以上
• uv パッケージ管理用

開発モードでの実行

# SSE モード
python -m hologres_mcp_server.main

# STDIO モード
python -m hologres_mcp_server.main --transport stdio

📚 ドキュメント

Cherry Studio 統合

1. GitHub リリースページ から Cherry Studio をインストールします。
2. Cherry Studio で MCP サーバーを設定します。
   • SSE モード：ホストとポートを使用します（例：http://localhost:8001）
   • STDIO モード：コマンドとパラメータを設定します。ドキュメント内のサンプルを参照してください。

💻 使用例

基本的な使用法

Python サンプル

SSE モードのクライアント

# 连接到 SSE 端点
sse_client = connect_to_sse()

# 初始化连接
initialize()

# 列出可用工具
tools_response = list_tools()

# 执行 SQL 查询
sql_result = call_tool("execute_sql", {
    "query": "SELECT 'Hello, Hologres!' AS greeting"
})

STDIO モードのクライアント

# 启动客户端
client = StdioClient(command)

# 初始化连接
client.send_message("initialize", {
    "clientInfo": {
        "name": "python-stdio-test-client",
        "version": "1.0.0"
    }
})

# 执行 SQL 查询
client.send_message("callTool", {
    "name": "execute_sql",
    "arguments": {
        "query": "SELECT 'Hello, Hologres!' AS greeting"
    }
})

Node.js サンプル

// 连接到 SSE 端点
eventSource = await connectToSSE();

// 初始化连接
await initialize();

// 执行 SQL 查询
const sqlResult = await callTool('execute_sql', {
  query: "SELECT 'Hello, Hologres!' AS greeting"
});

高度な使用法

ユニットテスト

テストファイル

# 测试初始化连接
def test_01_initialize(self):
    response = self.send_message("initialize", {
        "clientInfo": {
            "name": "test-client",
            "version": "1.0.0"
        }
    })
    
    self.assertIn("result", response)
    self.assertIn("protocolVersion", response["result"])

# 测试列出可用工具
def test_02_list_tools(self):
    response = self.send_message("listTools", {})
    self.assertIn("tools", response)

テストの実行

python -m pytest tests/

📄 ライセンス

このプロジェクトは Apache License 2.0 でライセンスされています。詳細については LICENSE ファイルを参照してください。

🔗 貢献ガイド

コミュニティからの貢献を歓迎します！詳細については CONTRIBUTING.md を参照してください。