企业官网建设流程全解析

如何让你的AI接入真实世界：nanobot MCP工具配置实战教程

【免费下载链接】nanobotUltra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps项目地址: https://gitcode.com/gh_mirrors/nanob/nanobot

nanobot 是一个用 Python 编写的超轻量、开源、可自托管的个人 AI Agent 框架，内置 WebUI、工具调用、长期记忆、MCP 集成与多渠道聊天应用。本文手把手教你通过MCP（Model Context Protocol）工具配置，让你的 nanobot AI 智能体接入浏览器、Notion、GitHub、网页搜索等真实世界能力——全程只需几步，新手也能 10 分钟完成。

为什么需要 MCP？给 AI 装上"双手" 🌐

大模型本身只会"说"，不会"做"。想让 AI 帮你查资料、操作浏览器、读写 Notion 笔记，就需要给它接上外部工具。

MCP（Model Context Protocol）正是目前主流的"AI 工具连接标准"：任何工具只要能发布为 MCP 服务器，就可以被支持 MCP 的智能体直接调用。nanobot 原生支持 MCP，外部工具会自动被发现并注册为智能体的原生工具，与内置的文件、Shell、网页、定时任务等工具一起使用，无需额外开发。

第一步：5 分钟装好 nanobot ✅

打开终端，执行以下命令即可安装并完成初始化向导：

python -m pip install nanobot-ai nanobot onboard --wizard nanobot agent -m "Hello!"

nanobot onboard --wizard会引导你完成模型、密钥等基础配置。当 AI 回复出 "Hello!" 后，就可以开始配置 MCP 工具了。

💡 提示：MCP 服务器本身还需要各自的运行环境（很多基于npx或uvx），nanobot 只负责连接和管理它们。

方法一：用 WebUI 图形界面配置 MCP（推荐新手）🖱️

nanobot 自带浏览器工作台 WebUI，MCP 配置几乎可以"零代码"完成：

nanobot webui

操作路径很简单：

1. 打开Apps → MCP，点击Add MCP server；
2. nanobot 内置了一批官方预设（Playwright 浏览器自动化、Context7 文档、Firecrawl 网页抓取、Parallel Search / Exa / Brave 搜索、Notion、Linear、GitHub、Figma、Supabase 等，预设定义见 mcp_presets_api.py），选一个即可；
3. 需要密钥的填入密钥，需要浏览器授权的（如 Notion、Linear）选择OAuth，保存后点击Connect，在浏览器窗口中批准访问即可；
4. 按需勾选要开放的工具，保存并在提示时重启；
5. 在下一条消息里用@提及该 MCP 服务器，提一个小测试任务（比如"帮我搜索今天的科技新闻"）。

整个过程不需要手写一行配置，OAuth 令牌会自动保存到 nanobot 数据目录，不会混进你的主配置里。

方法二：手动编辑 config.json 配置 MCP 服务器 📝

如果你习惯"配置即代码"或需要部署自动化，可以直接编辑~/.nanobot/config.json。nanobot 的 MCP 配置格式与 Claude Desktop / Cursor 兼容，可以直接从任意 MCP 服务器的官方说明中复制配置。

MCP 服务器有两种连接方式：

一个最小的 stdio 示例——让 AI 只拥有读取指定目录文件的权限：

{ "tools": { "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"], "enabledTools": ["read_file"] } } } }

远程 HTTP 服务则用url加请求头认证：

{ "tools": { "mcpServers": { "my-remote-mcp": { "url": "https://your-endpoint.example.com/mcp/", "headers": { "Authorization": "Bearer xxxxx" } } } } }

保存后重启 nanobot，MCP 工具会在启动时自动注册。更多字段说明可查阅 MCP 配置章节。

进阶技巧：生产环境最佳实践 🚀

① 只开放真正需要的工具。优先使用enabledTools限制工具范围，而不是默认暴露服务器上的所有工具——既降低风险，也能让模型选择更精准。

② 慢接口调超时。默认每次调用 30 秒，对较慢的 MCP 服务器可用toolTimeout单独调大，例如"toolTimeout": 120。

③ 远程 HTTP 服务支持 OAuth。手动配置时加"auth": "oauth"，再到 WebUI 的Apps → MCP中点击Connect完成浏览器授权即可。

④ 注意安全。stdio MCP 会启动本地进程，启用前请审查命令；HTTP/SSE 端点会经过 nanobot 内置的 SSRF 防护，默认拦截本机与内网地址，如需访问受信的内网 MCP，请在tools.ssrfWhitelist中用尽量窄的网段（如192.168.1.50/32）显式放行；密钥尽量通过环境变量或请求头传递，不要写在命令行参数里。

常见问题排查 🛠️

完整排错思路参考 MCP 工具配置指南 与 MCP 工具介绍。

写在最后

至此，你的 nanobot AI 已经接入了真实世界：查文档、抓网页、操作浏览器、管理笔记，一句话的事。MCP 工具的源码实现可以参考 nanobot/agent/tools/mcp.py，想深入了解预设管理机制可以看 nanobot/webui/mcp_presets_runtime.py。快去挑一个 MCP 服务器，给你的 AI 装上"双手"吧！🎉

【免费下载链接】nanobotUltra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps项目地址: https://gitcode.com/gh_mirrors/nanob/nanobot