纳米AI_MCP外部服务接入教程

纳米AI需通过MCP协议连接本地服务才能读取文件、查询数据库等，必须升级至v2.8.0+并配置mcp.json，启动对应MCP Server（如server-filesystem），且Server进程须持续运行。

让纳米AI（NanoAI）调用你本地的数据库、文件或API，必须通过MCP协议打通外部服务通道，否则它只能生成文字，无法读取你的Excel、查询公司MySQL、发送企业微信消息。

确认纳米AI是否支持MCP

打开纳米AI桌面端 → 点击左下角设置图标 → 进入「高级」页签 → 查看是否有「外部工具集成」或「MCP服务配置」开关。若无此选项，说明当前版本未启用MCP支持，需升级至v2.8.0及以上（2026年7月起所有正式版默认开启）。

这一步不能跳过——

准备本地MCP Server运行环境

把纳米AI理解成MCP客户端就行，它的职责主要是把调用请求发出去；真正执行任务的，其实是你在本地启动的MCP Server。就当前阶段来看，足够轻量、兼容性也更稳妥的方案，通常还是官方维护的 @modelcontextprotocol/server-filesystem（文件系统）和 @modelcontextprotocol/server-postgres（PostgreSQL）。

终端执行：

先执行 npm install -g npx，然后确认本机的 Node.js 版本已经达到 18.17 及以上，可通过运行 node --version 检查。要是系统提示 command not found，就需要先把 Node.js 补装好：Ubuntu/Debian 环境可运行 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs，或者直接用 nvm 重新安装。

编写mcp.json配置文件

在纳米AI配置目录下创建 mcp.json。Windows路径为 %APPDATA%NanoAIconfigmcp.json，macOS为 ~/Library/Application Support/NanoAI/config/mcp.json，Linux为 ~/.config/nanoai/config/mcp.json。

内容如下（以暴露桌面和文档两个目录为例）：

{

"mcpServers": {

"my-files": {

"command": "npx",

"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/Desktop", "/Users/yourname/Documents"]

}

}

}

注意：macOS/Linux路径中 /Users/yourname 必须替换成你真实的用户名；Windows用户请改用正斜杠格式，例如 C:/Users/YourName/Desktop。路径末尾不加斜杠，多路径之间用空格分隔。

启动MCP Server并验证连接

第一步：保持终端开启，进入任意目录，执行：

npx -y @modelcontextprotocol/server-filesystem /Users/yourname/Desktop /Users/yourname/Documents

你会看到类似 ✅ MCP server listening on stdio 的日志，表示服务已在标准输入输出模式启动。

第二步：回到纳米AI界面 → 设置 → 高级 → 「刷新MCP服务列表」按钮 → 等待3秒 → 列表中间出现 my-files (filesystem) 并显示绿色在线标识。

第三步：在聊天框输入：“列出我桌面上所有以report开头的Excel文件”，纳米AI会立即调用该Server扫描并返回结果。若超时或报错“no tools a vailable”，检查终端是否仍在运行npx命令——