Hologres MCP Server

🚀 Hologres MCP サーバー

Hologres MCP サーバーは、AI アプリケーションが Hologres データベースと簡単にやり取りできるようにするオープンソースプロジェクトです。3 種類の伝送モードをサポートし、Cherry Studio との統合も可能です。

🚀 クイックスタート

📦 インストール

Hologres MCP サーバーを実行するには、以下の手順に従ってください。

# リポジトリをクローンする
git clone https://github.com/your-repository.git
cd hologres_mcp_server

# 環境変数を設定する（オプション）
export HOLOGRES_MCP_SERVER_ENV=development

# サーバーを起動する（SSE モード）
uv main:main --port 8001

# または STDIO モード
uv main:main --transport stdio

# または HTTP Stream モード
uv main:main --transport http-stream

🌐 環境変数

サーバーを構成するには、以下の環境変数を設定します。

• HOLOGRES_MCP_SERVER_ENV：development や production などの実行環境を設定します。
• PORT：サーバーがリッスンするポートを指定します。デフォルトは 8001 です。
• DEBUG：デバッグモードを有効にするには true、無効にするには false を設定します。

✨ 主な機能

Hologres MCP サーバーは、Model Context Protocol (MCP) に準拠したオープンソースプロジェクトで、AI アプリケーションが Hologres データベースと簡単にやり取りできるように設計されています。以下の 3 つの伝送モードをサポートしています。

1. SSE（サーバー送信イベント）：WebSocket プロトコルを介したリアルタイム通信。
2. HTTP Stream：HTTP ロングポーリングを使用したストリーミング応答。
3. STDIO：標準入出力を介した直接通信。

💻 使用例

🔗 Cherry Studio との統合

Cherry Studio は、MCP サーバーをサポートするオープンソースの AI クライアントです。Hologres MCP サーバーと統合するには、以下の手順に従ってください。

1. Cherry Studio をダウンロードしてインストールする：GitHub リリースページにアクセスし、お使いのシステムに適したバージョンをダウンロードします。
2. MCP サービスを構成する：
   • SSE モード：Cherry Studio で http://localhost:8001 を入力します。
   • HTTP Stream モード：Cherry Studio で http://localhost:8001/mcp を入力します。
   • STDIO モード：構成例を参考に、コマンドとパラメーターを構成します。

💻 開発

📋 前提条件

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

🏠 ローカル開発

1. リポジトリをクローンする
2. 環境変数を設定する
3. 開発モードでサーバーを実行する：

# SSE モード
python -m hologres_mcp_server.main

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

# HTTP Stream モード
python -m hologres_mcp_server.main --transport http-stream

🧪 テスト

MCP Inspector を使用してテストします。

# MCP Inspector をインストールする
npx @mcp/core@latest inspector

# MCP Inspector の対応する URL パスを開く：
# - SSE モード：http://localhost:8001
# - HTTP Stream モード：http://localhost:8001/mcp

🔧 技術詳細

Model Context Protocol (MCP)

MCP は、AI アプリケーションとバックエンドサービスの間のやり取りに使用されるプロトコルです。Hologres MCP サーバーは、以下の機能をサポートしています。

• AI 統合：様々な AI モデルとのやり取りをサポートします。
• データ処理：Hologres データベースからのデータを処理および分析できます。
• リアルタイム通信：SSE または HTTP Stream を介した低遅延のリアルタイム通信を実現します。

📚 用語集

• SSE（Server-Sent Events）：サーバー送信イベント。クライアントがサーバーからのリアルタイム更新を受信できる技術です。
• HTTP Stream：HTTP ベースのロングポーリング技術で、ストリーミングデータ転送を実現します。
• STDIO：標準入出力。プログラムが stdin と stdout を介して通信する方法を指します。

上記の手順とガイドに従うことで、Hologres MCP サーバーをプロジェクトに簡単に統合し、その強力な機能を活用して AI アプリケーションとやり取りすることができます。