项目简介

Iggy MCP Server 是 Apache Iggy 项目的一部分，实现了 Model Context Protocol (MCP) 标准，允许 LLM 客户端实时访问和管理 Iggy 消息流平台中的流、主题和消息数据。

主要功能

• 实时流数据访问：让 LLM 能够读取和分析 Iggy 平台中的实时消息流
• 流管理：支持创建、列出和获取流信息
• 主题操作：管理流中的主题和分区
• 消息处理：支持发送和轮询消息
• 多协议支持：兼容 QUIC、WebSocket、TCP 和 HTTP 协议
• 多租户支持：通过流抽象实现数据隔离
• 高性能架构：基于 Rust 和 io_uring 技术，支持每秒处理数百万条消息

安装步骤

1. 克隆仓库

   git clone https://github.com/apache/iggy
   

2. 构建项目

   cargo build
   

3. 设置认证信息（可选）

   export IGGY_ROOT_USERNAME=iggy
   export IGGY_ROOT_PASSWORD=iggy
   

4. 启动 MCP 服务器

   cargo run --bin iggy-mcp-server
   

服务器配置

MCP 客户端需要配置以下信息来连接 Iggy MCP 服务器：

{
  "command": "cargo",
  "args": ["run", "--bin", "iggy-mcp-server"
}

基本使用方法

启动 MCP 服务器后，LLM 客户端可以通过 MCP 协议：

• 列出和浏览可用的流
• 查看流中的主题和分区信息
• 读取特定偏移量的消息内容
• 向流中发送新的消息数据

注意事项

• 服务器默认数据存储在 'local_data' 目录
• 支持多种传输协议（TCP、QUIC、WebSocket、HTTP）
• 可通过环境变量覆盖配置设置