用途
Agent Bridge 是一个模块化的 AI 智能体平台,用于连接 LangChain、FastAPI 与 Model Context Protocol(MCP)服务器。其目标是为远程 MCP 服务器提供端到端、可部署的生产级框架,帮助开发者摆脱本地 stdio 隔离的限制,构建和部署企业级智能体。项目已正式收录于 Awesome MCP Clients 仓库。
主要能力
- AI 智能体编排:在 FastAPI 后端之上集成 LangChain 与 LangGraph 状态机。
- 多服务器 MCP 支持:可跨多个 Model Context Protocol 服务器注册、管理和执行工具。
- 认证与安全:JWT 用户管理、bcrypt 密码哈希,以及支持 PKCE 的 OAuth 2.0(示例包括 Figma、Notion、GitHub)。
- 人工介入权限(Human-in-the-Loop):提供细粒度的工具执行控制与权限请求。
- 现代 Web 界面:基于 Vue 3、Vite、Tailwind CSS 与 Element Plus 组件的响应式前端。
- 实时流式传输:通过 SSE(Server-Sent Events)与 WebSocket 管道实现智能体交互流式输出。
- 灵活数据库层:使用 SQLAlchemy ORM 的 PostgreSQL 数据库,本地开发支持 SQLite。
使用方式
Docker 快速启动
- 克隆仓库:
git clone https://github.com/ramblinghermit0403/agent_bridge.git,然后cd agent_bridge。 - 配置环境变量:在
backend/(或server/,视具体设置而定)中创建.env文件:cp backend/.env.example backend/.env,并填入 API 凭据(如GOOGLE_API_KEY、OPENAI_API_KEY)。 - 启动服务:
docker-compose up --build。- 前端 UI:http://localhost:80
- 后端 API:http://localhost:8001
- PostgreSQL:localhost:5432
手动安装(开发)
- 后端设置:后端 API 将运行在 http://localhost:8001。
- 前端设置:Web 界面将运行在 http://localhost:5173。
- 文档设置:本地文档服务器运行在 http://localhost:5173(或下一个可用端口)。
配置
- MCP 服务器注册:要连接自定义 MCP 服务器,更新
backend/servers.json并运行引导脚本。 - 数据库迁移:数据库表在后端启动时自动生成;自定义模式变更可使用 SQLAlchemy 迁移。
适用场景
- 完整平台部署:面向工程团队、初创公司与企业。
- 学习与教育:面向学习 Agentic AI 与 MCP 的开发者。
- 模块化提取:面向产品开发者。
- MCP 服务器测试与沙箱:面向工具开发者与作者。
技术栈与安全治理
项目基于 FastAPI 与 LangChain 构建,遵循 Anthropic 的 Model Context Protocol 标准。安全方面包括:加密的 JWT 会话令牌与安全密码哈希、CORS 隔离与环境配置控制、基于角色的工具授权与实时执行审批请求。
限制
官方资料未提供具体的性能指标、收费模式、价格、平台兼容性细节或效果数据,这些信息暂未提供。项目采用 MIT 开源许可,欢迎通过 CONTRIBUTING.md 参与贡献。