🚀 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 集成
- 从 GitHub 发布页面 安装 Cherry Studio。
- 在 Cherry Studio 中配置 MCP 服务器：
- SSE 模式：使用主机和端口（例如
http://localhost:8001）。 - STDIO 模式：配置命令和参数，参考文档中的示例。
- SSE 模式：使用主机和端口（例如
📚 详细文档
单元测试
测试文件
# 测试初始化连接
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 获取详细信息。