纳米AI调用MCP工具失败的根源在于客户端与服务器握手未完成，需确认版本≥v0.9.3并启用MCP开关，正确配置mcp.json指向本地运行的filesystem服务器（如http://localhost:12305/mcp），重启后验证状态栏出现“MCP: connected”及工具调用响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让纳米AI（Nano AI）通过MCP协议调用本地浏览器、读取文件或查询数据库，但卡在配置环节，改完配置不生效、工具列表为空、调用时提示“server not found”——这通常不是模型问题，而是MCP客户端与服务器之间的握手没完成。
确认纳米AI是否原生支持MCP
打开纳米AI设置页 → 查看「高级功能」或「实验性选项」 → 找到“启用外部工具协议（MCP）”开关并开启。若该选项根本不存在，说明你当前版本低于v0.9.3（2026年6月起发布的正式版才内置MCP Client支持），需前往nanoai.dev/releases下载最新安装包覆盖升级。旧版强行配置MCP会完全静默失败，无任何报错提示。
验证方式：启动纳米AI后，在命令行执行 nanoai --version，输出中必须含 mcp: enabled 字样。
配置MCP服务器：两种路径任选其一
方法一：使用npm托管的轻量级服务器（推荐新手）
以文件读写为例，执行：npx -y @modelcontextprotocol/server-filesystem@latest --port 12305
终端出现 Server listening on http://localhost:12305/mcp 即表示启动成功。此命令会自动下载并运行，无需全局安装。
方法二：手动部署Python版服务器（适合企业环境）
克隆官方仓库：git clone https://github.com/modelcontextprotocol/servers.git && cd servers/python/filesystem
安装依赖：uv pip install -e .
启动服务：python -m mcp_servers.filesystem --port 12305
【注意】必须用 uv 而非 pip install，否则依赖解析会漏掉 pydantic-core 的特定版本，导致 tools/list 返回空数组。
在纳米AI中注册MCP服务器
第一步：定位配置文件
纳米AI使用全局单一配置，路径为：
Linux/macOS：~/.config/nanoai/mcp.json
Windows：%APPDATA%
anoaimcp.json
若该文件不存在，请手动创建。
纳米AI是一款基于人工智能大模型技术开发的智能应用工具，主要用于提供AI问答、内容生成、信息整理与智能搜索辅助等功能。用户可通过自然语言交互方式获取结构化信息与文本内容，用于学习、办公及内容创作等多种场景。
第二步：写入服务器定义
用文本编辑器打开 mcp.json，填入以下内容（仅保留一个 server 条目，不要套嵌数组）：{"filesystem":{"url":"http://localhost:12305/mcp"}}
保存后关闭编辑器。
第三步：重启纳米AI并触发初始化
完全退出纳米AI进程（任务管理器中确认 nanoai.exe 或 nanoai 进程已消失）→ 重新启动 → 在聊天框输入任意指令（如“你好”）→ 观察底部状态栏是否出现“MCP: connected”字样。未出现则说明配置未加载，常见原因是 JSON 格式错误（多逗号、缺引号）或端口被占用。
验证工具是否就绪并发起首次调用
在纳米AI聊天窗口输入：
“请读取我桌面的 README.md 文件内容”
若返回结构化错误（如 {"error":"tool_not_found","tool":"filesystem.read_file"}），说明服务器未正确暴露工具列表，需检查服务器日志中是否打印了 tools/list requested；若返回超时或连接拒绝，则是 url 地址写错或服务器根本没运行。
成功响应示例：
“已读取文件，共127行，首三行为：# Nano AI MCP Demo\n\nThis configures local file access…”
