Hologres MCP 服务器

Hologres MCP Server 是一个遵循 Model Context Protocol (MCP) 的开源项目，旨在为 AI 应用程序提供与 Hologres 数据库交互的能力。该项目提供了两种传输模式：SSE（Server-Sent Events）和 STDIO，并附带了完整的文档和示例代码。

文档内容

1. 介绍

Hologres MCP Server 实现了 MCP 协议，允许 AI 代理轻松访问 Hologres 数据库中的数据和功能。无论您是构建 AI 驱动的 IDE、增强聊天界面还是创建自定义 AI 工作流，MCP 都为连接 LLM 与所需上下文提供了一种标准方法。

2. 安装与运行

先决条件

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

开发模式运行

# SSE 模式
python -m hologres_mcp_server.main

# STDIO 模式
python -m hologres_mcp_server.main --transport stdio

3. 配置示例

Cherry Studio 集成

1. 从 GitHub 发布页面 安装 Cherry Studio
2. 在 Cherry Studio 中配置 MCP 服务器：
   • SSE 模式：使用主机和端口（例如 http://localhost:8001）
   • STDIO 模式：配置命令和参数，参考文档中的示例

4. 示例代码

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"
});

5. 单元测试

测试文件

# 测试初始化连接
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/

6. 许可证

本项目遵循 Apache License 2.0 协议。更多信息请参阅 LICENSE 文件。

7. 贡献指南

欢迎社区贡献！请参考 CONTRIBUTING.md 获取详细信息。

以上是 Hologres MCP Server 的完整中文翻译文档，涵盖了安装、配置、示例代码和测试等内容。