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 获取详细信息。