MCP 扩展系统

功能概述：通过模型上下文协议(MCP)扩展iFlow CLI能力
学习时间：15-20分钟
前置要求：完成基础操作，了解CLI基本使用

什么是 MCP

MCP（Model Context Protocol，模型上下文协议）是AI领域的"USB接口"，它在大模型和外部工具之间建立标准化连接。

核心特点

标准化协议：统一的通信标准，替代碎片化集成
安全连接：可控的双向数据交换
功能扩展：为AI助手添加专业工具能力
生态丰富：社区提供数百种MCP服务器

安装 MCP 工具

方法一：心流 MCP 市场（推荐）

访问心流MCP市场，搜索并复制安装命令，在终端执行安装命令：

# 基本语法
iflow mcp add-json 'server-name' '{JSON配置}'

# 示例：安装Playwright自动化工具
iflow mcp add-json 'playwright' "{\"command\":\"npx\",\"args\":[\"-y\",\"@iflow-mcp/playwright-mcp@0.0.32\"]}"


# 在iFlow CLI中执行（添加!前缀）需要手动刷新mcp列表
!iflow mcp add-json 'playwright' "{\"command\":\"npx\",\"args\":[\"-y\",\"@iflow-mcp/playwright-mcp@0.0.32\"]}"

/mcp refresh

以上命令都是在项目层面进行安装，如果确保所有项目都可见，在市场中复制对应的全局安装命令

iflow mcp add-json --scope user 'server-name' '{JSON配置}'

windows环境下使用转义后的JSON字符串配置
iflow mcp add-json --scope user 'server-name' "{JSON转义配置}"

方法二：使用 `/mcp online` 安装

在iFlow CLI中执行 /mcp online命令可以在线浏览MCP市场，选择合适的MCP进行安装

选中对应的MCP Server后，可以选择在项目范围内安装也可以在用户范围内安装(所有项目都可见)

方法三：使用命令行安装（高阶用户）

查看所有MCP命令：

iflow mcp --help

使用 `iflow mcp add-json` 命令安装

适用于有现成配置文件的场景：

# 基本语法
iflow mcp add-json <name> '<json-config>'

# 示例：天气API服务器
iflow mcp add-json weather-api "{
  \"type\": \"stdio\",
  \"command\": \"/path/to/weather-cli\",
  \"args\": [\"--api-key\", \"abc123\"],
  \"env\": {\"CACHE_DIR\": \"/tmp\"}
}"

# 验证安装
iflow mcp get weather-api

配置技巧：

确保JSON格式正确，注意转义字符
使用 --scope user 添加到全局配置
避免服务器名称冲突（系统会自动添加后缀）

使用 `iflow mcp add` 添加标准 stdio 服务器

适用于本地运行的工具：

# 基本语法
iflow mcp add <name> <command> [args...]

# 示例：本地文件处理工具
iflow mcp add file-manager python3 /path/to/file_manager.py

使用 `iflow mcp add --transport sse` 添加SSE 服务器

适用于需要实时通信的Web服务：

# 基本语法
iflow mcp add --transport sse <name> <url>

# 示例：连接远程API服务
iflow mcp add --transport sse analytics-api https://api.example.com/mcp

# 带认证的连接
iflow mcp add --transport sse secure-api https://api.example.com/mcp --auth-token YOUR_TOKEN

使用 `iflow mcp add --transport http` 添加远程 HTTP 服务器

# 基本语法
iflow mcp add --transport http <name> <url>

# 示例：连接到notion
iflow mcp add --transport http notion https://mcp.notion.com/mcp

# 带认证的连接
iflow mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

方法四：从社区安装

GitHub MCP服务器库

浏览：MCP服务器集合
自建：使用 MCP SDK

第三方市场

在平台上获取serverConfig配置后，使用 iflow mcp add-json 命令安装，确保JSON配置是一个合法的json字符串格式

提示💡：使用第三方 MCP 服务器需要您自担风险 - iFlow CLI 未验证所有这些服务器的正确性或安全性。确保您信任正在安装的 MCP 服务器。在使用可能获取不受信任内容的 MCP 服务器时要特别小心，因为这些可能会使您面临提示注入风险。

方法五：修改配置文件

配置文件相关详情可以参考: CLI配置文件说明

全局/用户范围可用的MCP 服务器在 iFlow 设置文件中配置，位置为 ~/.iflow/settings.json。配置定义了要连接的 MCP 服务器以及如何调用它们。

项目范围可用的MCP 服务器配置在项目文件夹的 .iflow/settings.json位置

`mcpServers`（对象）：

描述： 配置与一个或多个模型上下文协议（MCP）服务器的连接，用于发现和使用自定义工具。iFlow CLI 尝试连接到每个配置的 MCP 服务器以发现可用工具。如果多个 MCP 服务器暴露同名工具，工具名称将以您在配置中定义的服务器别名为前缀（如 serverAlias__actualToolName）以避免冲突。注意，系统可能会从 MCP 工具定义中剥离某些模式属性以保持兼容性。
默认值： 空
属性：
<SERVER_NAME>（对象）：命名服务器的服务器参数。
command（字符串，必填）：启动 MCP 服务器要执行的命令。
args（字符串数组，可选）：传递给命令的参数。
env（对象，可选）：为服务器进程设置的环境变量。
cwd（字符串，可选）：启动服务器的工作目录。
timeout（数字，可选）：对此 MCP 服务器请求的超时时间（毫秒）。
trust（布尔值，可选）：信任此服务器并绕过所有工具调用确认。
includeTools（字符串数组，可选）：要从此 MCP 服务器包含的工具名称列表。指定时，只有这里列出的工具才可从此服务器使用（白名单行为）。如果未指定，默认启用服务器的所有工具。
excludeTools（字符串数组，可选）：要从此 MCP 服务器排除的工具名称列表。这里列出的工具将不可用于模型，即使它们由服务器暴露。注意： excludeTools 优先于 includeTools - 如果工具在两个列表中，它将被排除。

示例：

"mcpServers": {
  "myPythonServer": {
    "command": "python",
    "args": ["mcp_server.py", "--port", "8080"],
    "cwd": "./mcp_tools/python",
    "timeout": 5000,
    "includeTools": ["safe_tool", "file_reader"],
  },
  "myNodeServer": {
    "command": "node",
    "args": ["mcp_server.js"],
    "cwd": "./mcp_tools/node",
    "excludeTools": ["dangerous_tool", "file_deleter"]
  },
  "myDockerServer": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "-e", "API_KEY", "ghcr.io/foo/bar"],
    "env": {
      "API_KEY": "$MY_API_TOKEN"
    }
  }
}

MCP 服务器管理

查看已安装的服务器

# 列出所有MCP服务器
iflow mcp list

# 查看特定服务器详情
iflow mcp get <server-name>

删除

# 删除MCP服务器
iflow mcp remove <server-name>

在iFlow CLI中管理

/mcp list

平台兼容性

支持平台

✅ macOS：完全支持
✅ Windows (WSL)：通过WSL支持
✅ Linux：原生支持
⚠️ Windows 原生：部分功能受限

配置位置

全局配置：~/.iflow/mcp/config.json
项目配置：{project}/.iflow/mcp.json
Claude Desktop 集成：自动读取Claude Desktop配置

故障排除

服务器无法启动

检查命令和参数是否正确
验证包是否已安装（针对 npm 包）
检查超时设置
查看 iFlow CLI 中的错误信息

连接问题

确保服务器支持 MCP 协议
检查网络连接（针对远程服务器）
验证环境变量设置是否正确

性能问题

调整超时值
检查服务器资源使用情况
考虑减少并发 MCP 服务器数量

最佳实践

从简单开始: 在添加自定义服务器之前先使用预配置的服务器
充分测试: 首先在安全环境中测试新的 MCP 服务器
监控性能: 关注响应时间和资源使用情况
保持更新: 定期更新 MCP 服务器包以获得安全性和功能改进
记录更改: 为团队成员记录自定义配置

使用示例

配置 MCP 服务器后，您可以在 iFlow 对话中利用它们的能力：

/mcp list
# 显示可用的 MCP 服务器

# 使用增强推理（sequential-thinking 服务器自动激活）
如何优化这个复杂的数据库查询？

# 利用上下文信息（context7 服务器自动激活）
在 Node.js 中实现身份验证的最佳实践是什么？

MCP 服务器在后台透明工作，增强 iFlow 的能力，在大多数情况下无需显式调用。

安全注意事项

使用第三方MCP服务器时：

⚠️ 验证服务器来源和可信度
⚠️ 审查服务器权限要求
⚠️ 注意提示注入攻击风险
⚠️ 定期更新服务器版本

推荐做法：

✅ 优先使用官方和知名开发者的服务器
✅ 在测试环境中先验证功能
✅ 定期审核已安装的服务器
✅ 保持服务器版本更新

下一步

完成MCP配置后，建议继续学习：

子代理配置 - 配置专业化AI助手
最佳实践 - 工作流优化技巧
高级配置 - 深度定制设置

获得帮助：📖 MCP官方文档 | 🐛 问题反馈

什么是 MCP​

核心特点​

安装 MCP 工具​

方法一：心流 MCP 市场（推荐）​

方法二：使用 /mcp online 安装​

方法三：使用命令行安装（高阶用户）​

使用 iflow mcp add-json 命令安装​

使用 iflow mcp add 添加标准 stdio 服务器​

使用 iflow mcp add --transport sse 添加SSE 服务器​

使用 iflow mcp add --transport http 添加远程 HTTP 服务器​

方法四：从社区安装​

方法五：修改配置文件​

mcpServers（对象）：​

示例：​

MCP 服务器管理​

查看已安装的服务器​

删除​

在iFlow CLI中管理​

平台兼容性​

支持平台​

配置位置​

故障排除​

服务器无法启动​

连接问题​

性能问题​

最佳实践​

使用示例​

安全注意事项​

下一步​