Hologres MCP 服务器

配置文件

要运行 Hologres MCP Server，请按照以下步骤操作：

安装和运行

# 克隆仓库
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 Server 介绍

Hologres MCP Server 是一个遵循 Model Context Protocol (MCP) 的开源项目，旨在使 AI 应用程序能够方便地与 Hologres 数据库交互。它支持以下三种传输模式：

1. SSE（服务器发送事件）：通过 WebSocket 协议实时通信。
2. HTTP Stream：使用 HTTP 长轮询实现流式响应。
3. STDIO：直接通过标准输入输出进行通信。

与 Cherry Studio 集成

Cherry Studio 是一个开源的 AI 客户端，支持 MCP 服务器。要将其与 Hologres MCP Server 集成，请按照以下步骤操作：

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 Server 支持以下功能：

• AI 集成：支持与各种 AI 模型进行交互。
• 数据处理：能够处理和分析来自 Hologres 数据库的数据。
• 实时通信：通过 SSE 或 HTTP Stream 实现低延迟的实时交互。

术语表

• SSE（Server-Sent Events）：服务器发送事件，一种允许客户端接收服务器推送实时更新的技术。
• HTTP Stream：基于 HTTP 的长轮询技术，用于实现流式数据传输。
• STDIO：标准输入输出，指程序通过 stdin 和 stdout 进行通信的方式。

通过遵循上述步骤和指南，您可以轻松地将 Hologres MCP Server 集成到您的项目中，并利用其强大的功能与 AI 应用程序进行交互。