MCP 扩展系统
功能概述：通过模型上下文协议(MCP)扩展iFlow CLI能力
学习时间：15-20分钟
前置要求：完成基础操作，了解CLI基本使用
什么是 MCP
MCP（Model Context Protocol，模型上下文协议）是AI领域的"USB接口"，它在大模型和外部工具之间建立标准化连接。
核心特点
- 标准化协议：统一的通信标准，替代碎片化集成
- 安全连接：可控的双向数据交换
- 功能扩展：为AI助手添加专业工具能力
- 生态丰富：社区提供数百种MCP服务器
工作原理
┌─────────────┐ MCP协议 ┌─────────────┐
│ iFlow CLI │ ←──────────→ │ MCP服务器 │
│ (大脑) │ │ (工具) │
└─────────────┘ └── ───────────┘
↑ ↓
AI推理 专业功能
(文件、网络、API等)
安装 MCP 工具
方法一：心流 MCP 市场（推荐）
访问心流MCP市场，搜索并安装工具：
# 基本语法
iflow mcp add-json 'tool-name' '{JSON配置}'
# 示例：安装Playwright自动化工具
iflow mcp add-json 'playwright' '{"command":"npx","args":["-y","@iflow-mcp/playwright-mcp@0.0.32"]}'
# 在iFlow CLI中执行（添加!前缀）
!iflow mcp add-json 'playwright' '{"command":"npx","args":["-y","@iflow-mcp/playwright-mcp@0.0.32"]}'
方法二：从社区安装
GitHub MCP服务器库
第三方市场
获取serverConfig配置后，使用 iflow mcp add-json 命令安装
方法三：命令行安装
查看所有MCP命令：
iflow mcp --help
配置方式详解
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添加到全局配置 - 避免服务器名称冲突（系统会自动添加后缀）
标准 stdio 服务器
适用于本地运行的工具：
# 基本语法
iflow mcp add <name> <command> [args...]
# 示例：本地文件处理工具
iflow mcp add file-manager python3 /path/to/file_manager.py
# 带参数的服务器
iflow mcp add database-tool node /path/to/db-tool.js --port 3000
SSE 服务器（Server-Sent Events）
适用于需要实时通 信的Web服务：
# 基本语法
iflow mcp add-sse <name> <url>
# 示例：连接远程API服务
iflow mcp add-sse analytics-api https://api.example.com/mcp
# 带认证的连接
iflow mcp add-sse secure-api https://api.example.com/mcp --auth-token YOUR_TOKEN
常用 MCP 工具推荐
开发工具类
| 工具名称 | 功能描述 | 安装命令 |
|---|---|---|
| Playwright | 浏览器自动化测试 | iflow mcp add-json 'playwright' '{"command":"npx","args":["-y","@iflow-mcp/playwright-mcp"]}' |
| Git Helper | Git仓库操作增强 | iflow mcp add git-helper git-mcp-server --repo ./ |
| Database | 数据库查询工具 | iflow mcp add db-tool database-mcp --connection-string "..." |
系统工具类
| 工具名称 | 功能描述 | 安装命令 |
|---|---|---|
| File System | 文件系统操作 | iflow mcp add filesystem file-system-mcp |
| System Monitor | 系统监控 | iflow mcp add monitor system-monitor-mcp |
| Network Tools | 网络诊断工具 | iflow mcp add network network-tools-mcp |
数据处理类
| 工具名称 | 功能描述 | 安装命令 |
|---|---|---|
| Excel Processor | Excel文件处理 | iflow mcp add excel excel-mcp-server |
| PDF Tools | PDF文档操作 | iflow mcp add pdf pdf-tools-mcp |
| Image Tools | 图像处理工具 | iflow mcp add image image-processor-mcp |
MCP 服务器管理
查看已安装的服务器
# 列出所有MCP服务器
iflow mcp list
# 查看特定服务器详情
iflow mcp get <server-name>
# 查看服务器状态
iflow mcp status <server-name>
更新和删除
# 更新MCP服务器
iflow mcp update <server-name>
# 删除MCP服务器
iflow mcp remove <server-name>
# 重启服务器
iflow mcp restart <server-name>
平台兼容性
支持平台
- ✅ macOS：完全支持
- ✅ Windows (WSL)：通过WSL支持
- ✅ Linux：原生支持
- ⚠️ Windows 原生：部分功能受限
配置位置
- 全局配置：
~/.iflow/mcp/config.json - 项目配置：
{project}/.iflow/mcp.json - Claude Desktop 集成：自动读取Claude Desktop配置
使用示例
示例1：自动化浏览器测试
# 安装Playwright MCP
!iflow mcp add-json 'playwright' '{"command":"npx","args":["-y","@iflow-mcp/playwright-mcp"]}'
# 使用场景
> 帮我测试网站 https://example.com 的登录功能
> 截图首页并检查是否有404错误
示例2：文件系统操作
# 安装文件系统工具
!iflow mcp add filesystem file-system-mcp
# 使用场景
> 分析项目目录结构，找出重复文件
> 批量重命名图片文件，按日期排序
示例3：数据库查询
# 安装数据库工具
!iflow mcp add db-tool database-mcp --connection-string "postgresql://..."
# 使用场景
> 查询用户表中最近30天的注册数据
> 生成销售报表的SQL语句并执行
故障排除
常见问题
安装失败
# 检查Node.js版本
node --version # 需要18+
# 检查网络连接
curl -I https://registry.npmjs.org/
# 查看详细错误日志
iflow mcp add <tool> --verbose
服务器不响应
# 检查服务器状态
iflow mcp status <server-name>
# 重启服务器
iflow mcp restart <server-name>
# 查看服务器日志
iflow mcp logs <server-name>
权限问题
# macOS：检查系统权限
System Preferences → Security & Privacy → Full Disk Access
# Linux：检查文件权限
chmod +x /path/to/mcp-server
# Windows：以管理员身份运行
安全注意事项
使用第三方MCP服务器时：
- ⚠️ 验证服务器来源和可信度
- ⚠️ 审查服务器权限要求
- ⚠️ 注意提示注入攻击风险
- ⚠️ 定期更新服务器版本
推荐做法：
- ✅ 优先使用官方和知名开发者的服务器
- ✅ 在测试环境中先验证功能
- ✅ 定期审核已安装的服务器
- ✅ 保持服务器版本更新
下一步
完成MCP配置后，建议继续学习：