8.6 MCP 服务（Model Context Protocol）

MCP（Model Context Protocol）是 Pop 的“工具扩展系统”，
允许 Pop 直接调用外部服务、文件系统、数据库、浏览器环境或第三方 API，
使 AI 不再是一个“纯聊天模型”，而是具备真实工具使用能力的智能体。

例如：

让 AI 自动读取本地文件
让 AI 使用浏览器工具抓取网页
让 AI 操作数据库
让 AI 使用命令行
让 AI 调用第三方 API（天气、搜索、翻译等）
通过自定义 MCP，将任何你自己的 API 暴露给 Pop

MCP 是 Pop 高级用户最重要的能力之一，本节将帮助你掌握其配置方式。

一、MCP 服务概览

MCP 服务的核心功能：

功能	说明
工具管理（Tools）	控制哪些工具对 AI 可用，例如 Filesystem、Browser 等
服务管理（Servers）	控制服务启动、停止、重启
权限管理	决定每个工具是否能访问本地资源或敏感接口
配置管理	设置服务路径、环境变量、端口等
调试功能	查看服务日志、通信状态、能力注册情况

Pop 内置 MCP 管理面板，可视化管理整个 MCP 生态。

二、已安装服务管理（Installed MCP Servers）

Pop 会自动扫描你本机或 Pop 自带的 MCP 服务，并在“系统设置 → MCP 服务”中统一展示。

你可以看到：

服务名称
服务类型（filesystem / browser / custom）
运行状态（运行中 / 已停止）
自动启动设置
服务日志按钮
工具列表

支持的操作

操作	描述
启动服务	手动启动 MCP 服务进程
停止服务	停止当前 MCP 服务
自动启动	Pop 启动时自动启动 MCP 服务
刷新工具列表	重新加载该服务提供的工具能力
查看日志	查看服务 stdout / stderr，用于调试

三、常见内置 MCP 服务

Pop 默认支持以下官方 MCP 服务（视安装情况而定）：

1. Filesystem（本地文件系统）

允许 AI：

读取文件内容
搜索目录
列出文件树
创建 / 编辑文件（可关闭风险功能）

🚨 出于安全考虑，默认仅开放 Pop 工作目录或用户指定目录。

2. Browser（浏览器抓取工具）

允许 AI：

访问任意 URL
抓取网页内容（HTML / 文本）
执行 DOM 查询
获取元数据（标题、描述等）

适合做：

知识检索
页面摘要
网页结构分析

3. Python / Node Sandbox（可选）

允许 AI：

执行安全沙箱内的 Python / Node 代码
数据处理
调用外部 API（受限）
绘图/计算等

四、服务目录与权限（Permissions）

每个 MCP 服务都可能包含一些敏感操作，因此 Pop 提供清晰的权限配置。

常见权限包括：

权限类型	用途
文件读权限	是否允许 AI 读取本地文件
文件写权限	是否允许 AI 写入文件（强烈建议审慎开启）
网络访问权限	是否允许外部 HTTP 请求
命令执行权限	是否允许调用系统命令
自定义目录白名单	限制 AI 访问特定目录
沙箱隔离模式	限制服务只能在 Pop 沙箱运行

你可以为每个工具单独配置权限，Pop 会在 AI 请求工具能力时进行提示与拦截。

五、自定义 MCP 服务（Custom MCP Server）

你可以自己开发一个 MCP 服务，并让 Pop 自动识别使用。

开发一个 MCP 服务需要：

选择语言（Node / Python / Rust 等）
实现 MCP 的标准协议（基于 JSON-RPC）
在本地写一个 server.json 声明文件
将服务路径加入 Pop 的“自定义服务目录”中
在 Pop 中刷新服务即可加载成功

示例用途：

连接你的 MySQL / Redis 数据库
集成你的公司内部 API
构建自动化脚本工具
产品研发的测试工具
实现你的私人知识处理服务

六、服务状态与调试（Debugging）

Pop 提供强大的 MCP 调试能力。

你可以查看：

服务启动日志
工具注册情况
AI 调用工具的请求记录
AI 与 MCP 服务之间的 JSON 通信
错误堆栈
工具耗时分析

这对开发自定义工具非常重要。

七、常见问题（FAQ）

Q：MCP 服务启动失败怎么办？

可能原因包括：

未授予执行权限
Node / Python 环境缺失
端口被占用
服务路径错误

检查日志可快速定位。

Q：AI 是否会无限制访问我的文件？

不会。

Pop 默认：

不开放写入权限
不开放系统根目录
用户必须手动授予权限

Q：自定义 MCP 服务是否可以部署远程？

可以，只要 MCP server 可通过本地进程或 WebSocket 方式连接即可。

总结

MCP 是 Pop 的扩展引擎，让 AI 不再是纯聊天模型，而具备真实的工具使用能力。
通过 MCP，你可以让 AI：

读写文件
抓取网页
访问数据库
执行脚本
集成你的自定义 API

它将 Pop 的能力扩展到了几乎无限的高度，是高级与专业用户的核心工具。