企业官网建设流程全解析

Snow CLI 是运行在终端里的 AI 编程智能体，同时兼容 DeepSeek、OpenAI、Gemini 和 Claude。本文是面向新手的Snow CLI MCP 配置完整教程，带你一步步通过 MCP（Model Context Protocol）协议为 Snow CLI 接入数据库、GitHub、文件系统等各类外部工具，让 AI 不只是"会聊天"，而是"能干活"。

什么是 MCP：AI 编程助手为什么需要它 🤖

MCP（Model Context Protocol）是一个开放协议，相当于给 AI 助手加了一套"标准 USB 接口"——只要外部工具实现了这个协议，Snow CLI 就能直接调用它。

配上 MCP 之后，Snow CLI 可以：

• 🗄️连接数据库：让 AI 直接查询、分析你的数据库表结构和数据
• 📁访问文件系统：读取指定目录下的文档、配置文件
• 🔗调用外部 API：对接公司内部系统、CI/CD、项目管理工具
• 📚接入知识源：把私有文档库变成 AI 的"外挂知识库"

MCP 的核心管理逻辑位于源码 source/utils/execution/mcpToolsManager.ts，服务注册、连接与缓存刷新都在这里完成。

三种服务类型，先搞懂再配置 ⚙️

在写配置之前，先了解 MCP 支持的传输类型：

一键进入配置：三步添加你的第一个 MCP 服务 🚀

第 1 步：从主菜单进入 MCP 配置

启动 Snow CLI 后，在主菜单中用上下箭头选择MCP 设置（英文界面为 MCP Settings），按回车进入：

第 2 步：选择配置范围（Scope）

进入后会让你选择配置写入的位置：

💡经验法则：只有当前仓库需要的服务（比如只查这个项目的数据库）放项目级；到处都要用的（比如 GitHub）放全局。同名服务项目级优先。

第 3 步：编辑配置并保存

系统会自动检测并用合适的文本编辑器打开配置草稿（检测顺序：VISUAL→EDITOR→ 系统默认；Linux/macOS 依次尝试 nano > vim > vi，Windows 依次尝试 notepad++ > notepad > code > vim > nano）。

MCP 配置统一存放在settings.json的mcpServers字段中（旧的独立mcp-config.json文件会在启动时自动迁移）。保存后系统会自动校验 JSON 格式——写错了会提示"JSON 格式无效，修改已回退至上一个有效配置"，不用担心把配置改坏。

配置界面的实现见 source/ui/pages/MCPConfigScreen.tsx。

核心配置项速查表

最常用的配置项如下（type可省略，系统会按command/url自动推断）：

接入本地文件系统服务示例（stdio模式）：

{ "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"], "enabled": true } } }

连接远程数据库服务示例（http模式，适合团队共享的 MCP 服务）：

{ "mcpServers": { "db-service": { "type": "http", "url": "https://your-mcp-host.com/mcp", "headers": { "Authorization": "Bearer ${API_KEY}" }, "env": { "API_KEY": "your_api_key_here" } } } }

⚠️settings.json里通常还有其他设置（如yoloMode）。新增 MCP 时请合并写入mcpServers，不要覆盖整个文件。

用 /mcp 指令管理服务：状态一目了然 🔍

配置完成后重启 Snow CLI（运行snow命令），然后输入/mcp指令打开服务面板。该指令由 source/utils/commands/mcp.ts 注册，面板实现见 source/ui/components/panels/MCPInfoPanel.tsx。

面板中每个服务一行，绿点 ● 表示已连接，红点 ● 表示连接失败，灰点 ● 表示已禁用，还会标注服务来源（项目级/全局）：

面板键盘操作：

💡 小技巧：在工具列表页可以按 Tab 单独禁用某个工具（比如只让 AI 查询、不让它改库），精细控制比"全开/全关"安全得多。

故障排除：连接失败怎么办 🛠️

1. 提示找不到编辑器（No text editor found!）

# macOS / Linux export EDITOR=nano

2. 服务显示红色 ● 连接失败

按顺序检查：命令路径是否正确 → 依赖是否已安装（如npx需要 Node.js）→ 参数格式是否正确。具体错误信息可在/mcp面板中直接查看。

3. 配置不生效

确认已保存 → 重启 Snow CLI → 用/mcp查看状态。记住：修改配置后必须重启才生效。

4. 想临时关掉某个内置服务

在.snow/settings.json中通过disabledBuiltInServices字段禁用，例如禁用snow-docs：

{ "disabledBuiltInServices": ["snow-docs"] }

总结 🎯

Snow CLI 的 MCP 配置可以归纳为三步：主菜单进 MCP 设置 → 选项目级或全局范围 → 编辑mcpServers保存重启。配合/mcp面板的日常管理，你就能把数据库、文件系统和任意外部 API 都变成 AI 的"手和脚"。

更多细节可参考官方文档：14.MCP配置.md。