开源的 MCP-Native Agent 框架与独立 MCP Host，将 MCP Servers 转化为功能丰富的 AI Agent，支持多模型、可嵌入部署、自带交互式聊天客户端。
Nanobot 是一个专为 MCP (Model Context Protocol) 生态构建的开源 Agent 框架，定位为独立、可自定义的 MCP Host。由 nanobot-ai 组织（Obot.ai 团队）维护，采用 Apache 2.0 许可证开源。
核心特性#
MCP-Native 设计#
- 从底层专为 MCP 生态构建
- 完整支持 MCP 特性：tools、prompts、sampling、elicitation 等
- 所有功能通过 MCP servers 交付，框架本身不绑定特定功能实现
Agent 即 MCP Server#
每个 Nanobot agent 同时也是一个 MCP server，可被任何 MCP 客户端访问，实现 Agent ↔ MCP Server 双向映射。
MCP-UI 支持#
- 一流 MCP-UI 规范支持
- 可在聊天客户端内渲染交互式 React 组件
- 构建可玩游戏（如21点）、购物车、仪表盘等丰富交互体验
多模型支持#
- OpenAI (gpt-4 系列)
- Anthropic (claude-3 系列)
灵活配置方式#
单文件配置 (nanobot.yaml):
agents:
dealer:
name: Blackjack Dealer
model: gpt-4.1
mcpServers: blackjackmcp
mcpServers:
blackjackmcp:
url: https://blackjack.nanobot.ai/mcp
目录式配置:
my-config/
├── agents/ # Agent 定义目录
│ ├── main.md # 主 agent（自动设为入口）
│ └── helper.md # 额外 agent
└── mcp-servers.yaml # MCP server 定义
可嵌入部署#
- 完整的 MCP Host，带交互式聊天客户端
- 可部署于任何环境
- 可嵌入到任何应用或网站
安装与快速开始#
# 通过 Homebrew 安装
brew install nanobot-ai/tap/nanobot
# 设置 API Key
export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...
# 运行
nanobot run ./nanobot.yaml
# 访问 Web UI
# http://localhost:8080
官方示例#
| 示例 | 描述 |
|---|---|
| Blackjack Game | 21点游戏 agent |
| Hugging Face MCP | HuggingFace 集成 agent |
| Shopping/Shopify | 电商购物助手 |
应用场景#
- 定制化 AI 聊天机器人
- 游戏化交互体验
- 电商购物助手
- 企业级 AI Agent 集成
- 多渠道部署（Slack、SMS、email、嵌入式 web agents）
项目状态#
- 当前版本：v0.0.55
- 阶段：Alpha，活跃开发中
- 贡献者：12 人