Hologres MCP Server Sse

🚀 Hologres MCP 服務器

Hologres MCP 服務器是一個開源項目，它遵循 Model Context Protocol (MCP)，主要為 AI 應用程序賦予與 Hologres 數據庫進行交互的能力。此項目提供了 SSE（Server-Sent Events）和 STDIO 兩種傳輸模式，同時還附帶了完整的文檔和示例代碼。

🚀 快速開始

Hologres MCP 服務器實現了 MCP 協議，藉助該協議，AI 代理能夠輕鬆訪問 Hologres 數據庫中的數據和功能。無論你是在構建 AI 驅動的 IDE、增強聊天界面，還是創建自定義 AI 工作流，MCP 都為連接大語言模型（LLM）與所需上下文提供了一種標準方法。

✨ 主要特性

• 遵循 Model Context Protocol (MCP)，為 AI 應用與 Hologres 數據庫交互提供支持。
• 提供 SSE（Server-Sent Events）和 STDIO 兩種傳輸模式。
• 附帶完整的文檔和示例代碼，便於開發者使用。

📦 安裝指南

先決條件

• Python 3.10 或更高版本
• uv 用於包管理

開發模式運行

# SSE 模式
python -m hologres_mcp_server.main

# STDIO 模式
python -m hologres_mcp_server.main --transport 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"
});

高級用法

Cherry Studio 集成

1. 從 GitHub 發佈頁面 安裝 Cherry Studio。
2. 在 Cherry Studio 中配置 MCP 服務器：
   • SSE 模式：使用主機和端口（例如 http://localhost:8001）。
   • STDIO 模式：配置命令和參數，參考文檔中的示例。

📚 詳細文檔

單元測試

測試文件

# 測試初始化連接
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 獲取詳細信息。