Nanobot

Nanobot 是由 Obot AI（原名 Acorn Labs，获 $35M Seed 融资）开发的开源 MCP Host 框架，核心定位是将仅暴露工具函数的 MCP Server 升级为具备人格、推理能力和用户界面的完整 AI Agent。项目采用 Go 语言（84.4%）构建后端 MCP Host 引擎，Svelte（10.1%）构建内嵌聊天 UI，支持通过 nanobot.yaml 单文件或 agents/*.md 目录式配置定义 Agent。

核心能力#

• MCP Host 引擎：作为独立 MCP Host 运行，连接 MCP Server 与 LLM，目标实现完整 MCP + MCP-UI 合规
• Agent 定义与编排：单文件配置定义 Agent 名称、模型、绑定的 MCP Server；目录式配置支持多 Agent，agents/main.md 自动设为默认入口
• 多 LLM 提供商：内置 OpenAI（如 gpt-4）和 Anthropic（如 claude-3）支持，通过 llmProviders 配置扩展至 Azure OpenAI、AWS Bedrock、Ollama 等，可灵活指定 API 协议方言（OpenAIResponses、OpenAIChatCompletions、AnthropicMessages、OpenResponses）和自定义端点
• MCP-UI 富交互：支持 MCP-UI 协议，允许 Agent 在聊天界面中渲染按钮、图形、表单、商品卡片、购物车等富交互元素
• 内嵌 Web UI：基于 Svelte 的聊天界面，默认运行在 http://localhost:8080
• 多渠道部署：Agent 可通过聊天、语音、短信、邮件、Slack 等多种界面与用户交互

典型场景#

• 将内部 API / 工具快速封装为对话式前端
• 构建游戏类 Agent（如 Blackjack Dealer），在聊天中渲染完整游戏界面
• 电商购物 Agent，接入 Shopify 等服务，展示商品卡片、购物车、订单历史
• 作为独立服务部署或嵌入第三方应用

安装与快速开始#

# Homebrew 安装
brew install obot-platform/tap/nanobot

# 从源码构建
make

最小配置示例（nanobot.yaml）：

agents:
  dealer:
    name: Blackjack Dealer
    model: gpt-4.1
    mcpServers: blackjackmcp

mcpServers:
  blackjackmcp:
    url: https://blackjack.nanobot.ai/mcp

export OPENAI_API_KEY=sk-...
nanobot run ./nanobot.yaml

启动后浏览器访问 http://localhost:8080 即可使用。项目还提供 Dockerfile 和 Dockerfile.agent 支持容器化部署。

架构要点#

• 后端：Go 语言实现，入口 main.go，核心逻辑位于 pkg/ 目录
• 前端：Svelte 实现，位于 packages/ui/，使用 pnpm workspace 管理，开发时 port 5173，由后端 port 8080 代理转发
• 构建与发布：Makefile + go.mod 管理，.goreleaser.yml 驱动 release 自动化
• 测试与 CI：integration_test/ 目录用于集成测试，.github/workflows/ 实现 CI/CD
• 组织关系：与 Obot MCP Gateway 同属 Obot AI 组织下的互补产品

注意事项#

当前项目处于 Alpha 阶段（v0.0.80，已有 81 个 release），README 明确声明 "under heavy development"，正在偏离原始设计意图，预期会有重大破坏性变更和架构迁移。nanobot.ai 域名已重定向至 obot.ai，Nanobot 是否会被完全合并进 Obot 平台尚不明确。项目采用 Apache-2.0 许可证。