Hubloom

Hubloom 是一个开源的企业智能体互联与编排平台

给企业现有 REST 后台接一层自然语言入口：用户用对话的方式查数据、调接口，而无需改动原有业务系统。传入 Swagger/OpenAPI 即可自动生成可调用的工具集；经评估路由分流为快答 / 深度思考两条路径，安全、可解释地调用企业 API，并支持会话历史及可选的记忆与 RAG 增强。

Hubloom 不仅是「用自然语言操作 API」，更是企业智能体技术栈中的编排与互联枢纽。MCP 负责连接工具与数据（已支持）；A2A 为下一步推进方向，用于跨 Agent 任务委托；ANP 在路线图中，面向更开放的 Agent 互联协作。

在线体验

https://hubloom.onrender.com

在左侧填写模型 API Key 与 Swagger 接入信息，点击「连接 Swagger」即可开始对话。密钥仅保存在浏览器本地，不会上传服务端。免费实例闲置后会休眠，首次打开可能需要等待约 30～60 秒。

Related MCP server: Swagger MCP

特性

• Swagger → MCP：从 OpenAPI/Swagger 动态生成工具，换一套 API 只需改环境变量

• 双路径编排：评估路由后自动分流——简单问答走快答，查数/调接口走深度思考

• 真实 API 调用：深度思考路径通过 MCP 调用企业 REST API，基于真实返回作答，不编造业务数据

• 可解释执行：展示推理与工具调用过程，回复可追溯、可核对

• 会话与增强：多轮对话历史；可选长期记忆与 RAG 知识库

架构文档

Hubloom 采用分层设计：用户侧 Web 对话 → ADP 编排（快答 / 深思考）→ MCP 适配（Swagger 转工具、代理企业 API）→ 可选的长期记忆与 RAG 增强。各层职责与链路详见 docs/：

快速开始

环境要求

• Python 3.12+

• uv（推荐）或 pip

1. 安装依赖

uv sync

或使用 pip：

pip install -r requirements.txt

2. 配置环境变量

cp .env.example .env

至少填写 OPENAI_API_KEY；对接业务 API 时配置 MCP_*：

OPENAI_API_KEY=sk-...
OPENAI_MODEL=...
OPENAI_BASE_URL=...
MCP_SWAGGER_URL=https://your-api.example.com/swagger/v1/swagger.json
MCP_BASE_URL=https://your-api.example.com
MCP_TOKEN=your-token

完整变量见下方 配置说明。

3. 启动服务

PYTHONPATH=. uv run python main.py

默认监听 http://127.0.0.1:8000。可通过 CORTEX_API_HOST、CORTEX_API_PORT 调整。

4. 开始对话

• Web 对话页：http://127.0.0.1:8000/

• API 文档：http://127.0.0.1:8000/docs

健康检查

curl http://127.0.0.1:8000/health

调用对话接口

curl -s http://127.0.0.1:8000/v1/chat \
  -H "Content-Type: application/json" \
  -H "X-Session-Id: demo-session" \
  -d '{"message":"你好，你能做什么？","stream":false}'

默认开启 SSE 流式（"stream": true）。生产接入时，建议由业务后端验签后转发请求，并透传 Authorization 与 X-Session-Id。

配置说明

复制 .env.example 为 .env 后按需修改。下表按用途分组，未列出的可选变量以 .env.example 为准。

LLM

MCP / 业务 API

未配置 MCP_SWAGGER_URL 时使用 Petstore 示例 spec。

会话与存储

RAG 知识库（可选）

长期记忆（可选）

HTTP 服务

日志

路线图

当前版本

• OpenAPI → MCP 工具生成

• 评估路由 → 快答 / 深度思考双路径

• HTTP API、SSE 流式与 Web 对话页

• 多轮会话（SQLite）

• 可选长期记忆与 RAG 知识库

• MCP 适配层重构：统一 API 响应结构处理，精简 FastMCP 集成，Gateway + Worker 按 tag 分组

• MCP 工具过滤：按 tag 限制暴露工具，适配大型 Swagger

下一步

• A2A 协议接入：跨系统 Agent 任务委托与能力发现

• Agent 互联编排：Hubloom 作为编排枢纽，支持将子任务委托给外部 Agent

• A2A 与现有 ADP 集成：Assessor / Thought 路径扩展为多 Agent 协作场景

协议栈演进

• MCP — 连接企业 API 与数据（已完成）

• A2A — 跨系统 Agent 任务委托（进行中）

• ANP — 更开放的 Agent 互联与协作（探索中）

许可证

本项目基于 Apache License 2.0 开源发布。