EN 立即下载

MCP 扩展

MCP（Model Context Protocol）是一种让 AI 连接外部工具的开放协议。通过 MCP，你可以让旗鱼的 AI Agent 直接查询数据库、调用 API、操作各种外部服务——就像给 AI 安装了一个个专用插件。

什么是 MCP

没有 MCP 时

AI 想查数据库，需要通过终端间接操作：

你: 查一下用户表有多少人
AI: [执行 mysql -u root -p -e "SELECT COUNT(*) FROM users"]
    → 需要知道密码、处理命令行输出格式...

有了 MCP 后

AI 直接通过结构化接口操作：

你: 查一下用户表有多少人
AI: [调用 MySQL MCP 工具的 query 方法]
    → 直接拿到结构化结果，更快更准确

MCP 生态中已有大量开源工具，覆盖数据库、文件系统、版本控制、云服务等领域。

添加 MCP 工具

使用预设模板（推荐）

旗鱼内置了常用 MCP 工具的预设模板：

  1. 打开 设置 → MCP 配置
  2. 点击「添加」
  3. 在模板列表中选择需要的工具（如 MySQL、PostgreSQL 等）
  4. 填入必要的配置信息（如数据库地址、用户名、密码）
  5. 保存并启用

手动配置

如果没有预设模板，可以手动配置任何符合 MCP 协议的工具：

  1. 点击「添加」→「手动配置」
  2. 填写配置信息：
字段说明示例
名称自定义名称，便于识别「生产数据库」
传输方式stdio（本地进程）或 SSE（远程服务）stdio
命令启动 MCP 服务器的命令（stdio 模式）npx @modelcontextprotocol/server-mysql
参数命令行参数--host 10.0.1.50 --port 3306
环境变量传递给 MCP 进程的环境变量MYSQL_PASSWORD=xxx
URLMCP 服务器地址（SSE 模式）http://localhost:8080/sse

两种传输方式

传输方式工作原理适用场景
stdio旗鱼启动一个本地进程，通过标准输入/输出通信大多数场景（推荐）
SSE连接远程 HTTP 服务器，通过 Server-Sent Events 通信MCP 服务部署在远程服务器上

常用 MCP 推荐

MCP 工具功能适用场景
mysql查询和操作 MySQL 数据库数据分析、数据库运维
postgres查询和操作 PostgreSQL数据分析、数据库运维
sqlite操作 SQLite 数据库本地数据文件分析
filesystem增强的文件系统操作复杂文件管理
gitGit 仓库操作（提交、分支、日志）代码管理和审查
fetch发送 HTTP 请求调用 REST API
puppeteer浏览器自动化网页截图、爬取数据
memory持久化的知识图谱存储结构化信息
everythingWindows 文件搜索快速定位文件

完整的 MCP 工具列表可以在 MCP 官方目录 中浏览。

使用 MCP 工具

配置好 MCP 后，AI 会自动识别可用的工具，在需要时调用。你只需要用自然语言描述需求：

数据库查询

查询一下 users 表中最近 7 天注册的用户数量

看看 orders 表中今天的订单总金额是多少

找出 products 表中库存低于 10 的商品清单

API 调用

调用我们的内部 API，获取当前在线用户数

文件搜索

帮我在整台电脑上搜索名字里包含 "报告" 的 Word 文件

管理 MCP 工具

在设置页面的 MCP 配置区域中可以：

操作说明
启用/禁用临时停用某个 MCP 工具（不删除配置）
重新连接MCP 进程意外断开时重连
查看工具列表查看该 MCP 提供了哪些工具和参数
编辑修改配置（如数据库地址变了）
删除移除不需要的 MCP 配置

常见问题

MCP 工具启动失败

  • 确认相关的 npm 包已全局安装（大多数 MCP 工具通过 npx 运行）
  • 检查 Node.js 版本是否满足要求（建议 18+）
  • 查看旗鱼日志中的错误信息

数据库 MCP 连接不上

  • 确认数据库地址、端口、用户名、密码正确
  • 确认数据库允许来自本机的连接
  • 检查防火墙是否放行了对应端口

MCP 工具没被 AI 调用

  • 确认 MCP 状态为「已连接」
  • 尝试在提示中明确提到要使用的功能（如「用数据库查询」）
  • 检查 MCP 工具列表，确认提供了你需要的工具