运行本地 MCP 服务器前应问的七个问题
用于隔离本地MCP服务器的检查清单,已在GitHub服务器上验证:短有效期令牌、封闭式网络、出站允许列表以及固定工具列表。
来源: the seven questions i ask before running a local mcp server — part 2
安装本地 MCP 服务器通常意味着将一段代码粘贴到配置文件中:
{
"mcpServers": {
"some-tool": { "command": "npx", "args": ["-y", "some-mcp-server"] }
}
}
总共只有三行代码,既没有审核流程,也没有权限对话框,更没有人们通常会考虑的安装步骤。值得仔细看看这几行代码的作用。本地MCP服务器并非一种服务,它没有端口、无需登录,也没有边界限制。它只是由代理程序启动的一个程序,以当前用户的身份运行,能够访问该用户的文件和环境。代理程序显示的权限提示反映了代理的功能,而工具调用背后的程序早已获得了对整台机器的操控权。
更好的做法是在安装之前先提出七个问题,再根据答案来配置相关设置。
七个问题
- 它能在本地运行吗?远程MCP服务器位于第三方的机器上,无法被限制在特定环境中,这使得列表中的其他问题都变得无关紧要。有时这并非固定选项,而是需要自行决策,谨慎选择远程或本地模式就能让其余六个问题不再存在。
- 它需要凭据吗?要么不需要,要么需要一个可以明确指定的特定凭据。
- 它连接到哪里?要么是简短的固定主机列表,要么是任意URL。
- 它需要哪些文件?一个工作空间、所有文件,或者什么都不需要。
- 它还需要主机提供其他什么吗?桌面会话、套接字、浏览器等。
- 它会运行下载的代码吗?如果是这样,那么这些代码就需要被固定下来。
第一到第六个问题可以通过服务器自身的文档在大约十分钟内得到解答,无需深入查找其他来源。只有第七个问题有具体的数据支持:安装后会执行一次tools/list命令,其返回的工具数量往往超出预期。
实例分析:GitHub服务器
| 问题 | GitHub服务器的答案 |
|---|---|
| 可在本地运行吗? | 可以,且已以容器镜像的形式提供 |
| 需要凭据吗? | 需要,因为无法匿名读取私有仓库 |
| 连接地址 | 仅一个主机,即api.github.com |
| 处理的文件 | 除密钥外无其他内容。操作通过 API 完成,因此磁盘上不存在克隆或检出文件。 |
| 其他主机需求 | 无 |
| 运行时获取代码 | 否 |
| 工具列表 | 可通过 --toolsets 和 --exclude-tools 进行筛选。 |
综合来看,这些答案明确了配置要求:一个凭证、无需挂载文件夹、单一目标地址,以及需要筛选的工具列表。
凭证是最难处理的部分,因为其设计上无法被移除。如果代理要提交拉取请求,就必须拥有写入权限。因此采用其他限制措施,首先使用 GitHub 应用 而非个人访问令牌:
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--network",
"mcp-egress-github",
"--read-only",
"--tmpfs",
"/tmp",
"--cap-drop",
"ALL",
"--security-opt",
"no-new-privileges",
"--user",
"10001:10001",
"--log-driver",
"journald",
"-e",
"HTTPS_PROXY=http://mcp-egress-proxy:3128",
"-e",
"HTTP_PROXY=http://mcp-egress-proxy:3128",
"-v",
"/home/<user>/.config/mcp-gh/<app>.private-key.pem:/key.pem:ro",
"ghcr.io/github/github-mcp-server@sha256:508a0857ec762b1ab1cece29193345b501fab1dd9d1228a7b617062954cecac6",
"stdio",
"--app-id",
"NNNNNNN",
"--app-installation-id",
"NNNNNNNNN",
"--app-private-key-path",
"/key.pem",
"--toolsets",
"context,issues,pull_requests,repos",
"--exclude-tools",
"create_repository,fork_repository,get_teams,get_team_members,list_repository_collaborators"
]
}
}
}
该凭证周围的防护层
- 短期有效的令牌。GitHub 应用会生成很快过期的令牌。
- 只读挂载。签名密钥以只读方式挂载,其所有权属于容器映射到的 UID,而非用户。它不会存放在
~/.ssh中,这样它既不是 SSH 密钥,用户也无法再读取它。 - 无特权的容器。Docker 守护进程以无根模式运行,进程使用非根用户,且不会被授予任何特殊权限。
- 一个仓库,四种权限。
contents、issues和pull_requests具有写入权限,metadata具有读取权限,每个生成的令牌也仅具备相应的权限。 - 封闭的网络。没有直接的外联路径,因此只能通过代理进行访问。
api.github.com。--toolsets用于屏蔽整个工具组,而--exclude-tools则可移除这些保留工具组中剩余的工具。最后两种方法很少被重视。在保留写入权限的前提下,缩减工具列表属于最低权限设置。允许列表的保护范围不仅限于本地文件,因为它还能限制被盗取的凭证的使用范围。
这一说法需要具体数据支撑。通过 --toolsets context,issues,pull_requests,repos,服务器会提供42种工具,但其中5种无法在当前权限下使用。应用 --exclude-tools 后,剩余37种工具,其中15种具备写入权限。由于 --toolsets 是按整组选择的,因此无论令牌是否有权限使用,repos 选项都会包含 create_repository 和 fork_repository 这两种功能。37虽然不是个小数字,但却是真实的数据,也体现了当代理程序确实需要推送分支时应有的最小权限设置。
为何允许列表并非过度严格
起初,允许列表看起来过于繁琐,直到有人询问它究竟能阻止什么。由于无法迫使容器与attacker.com建立连接,因此在其中生成的令牌也就没有可前往的恶意目标。代理服务器日志会记录每次尝试的两种结果:
10.123.2.3 TCP_TUNNEL/200 CONNECT api.github.com:443 HIER_DIRECT/140.82.121.6
10.123.2.3 TCP_DENIED/403 CONNECT example.com:443 HIER_NONE/-
-e HTTPS_PROXY 参数并不能强制实现这一功能。Linux 并没有内置的代理概念,既没有内核级开关,也没有 libc 的钩子机制。该变量仅仅是环境中的文本,各个 HTTP 客户端可自行决定是否遵循它。Go 语言的 net/http 会遵循该设置,因此这类服务器无需额外处理。Node 语言内置的 fetch 函数则不会遵循该设置,这意味着 Node 服务器会完全忽略该参数。真正的保障在于网络架构:在没有出站路由的情况下,忽略该变量的客户端不会直接建立连接,而会直接报错。而在有路由的网络环境中,同样的疏忽会导致流量在毫无预警的情况下泄露。
与 OWASP MCP Top 10 的对比
将该配置与OWASP MCP Top 10相对应后,每个风险会被标记为已处理、仍有残留且处于可控状态、未处理,或不适合本地stdio服务器,并会注明哪些风险仍未解决。
哪些内容仍在范围之外
没有任何沙箱是完美无缺的。有三个主题完全不在该配置的覆盖范围内:远程MCP服务器、能够获取任意URL的服务器以及模型本身。
超过这个范围后,问题就不再是被遗忘的标志而已。所有这些控制措施都是针对每个容器单独设置的,需要手动编写,且每添加一台服务器就必须重复配置。三台服务器需要三份允许列表和三组工具集字符串,而且没有任何组件能够监控整个会话。
所缺失的是位于代理与其服务器之间的网关。网关可以将某个工具从list_tools中完全移除,并在转发请求前重新检查每一项调用,这样工具列表就会根据每次会话进行更新,而非仅依据配置文件。但它仍然无法监控正在运行的服务器的行为:如打开的文件、连接的主机以及读取的凭证。一旦服务器被攻破,无需通过工具调用即可将密钥发送到其他地方。网关只是在原有结构之上增加了一层,并不会移除现有的任何层。
适用于所有本地服务器的规则
上述内容针对的是GitHub。它们制定的规则同样适用于任何即将被添加到配置文件中的本地服务器:
- 选择会过期的凭证。使用 GitHub 应用比个人访问令牌更安全。容器会保存签名密钥,并每次使用时生成新的令牌,这些令牌会自动失效,无需他人手动撤销。
- 控制权限范围,而不仅仅是凭证本身。指定一个仓库和四种权限,每个令牌都仅包含这些权限。
- 封闭网络访问。由于没有预设的路由,代理设置无法被服务器拒绝,而
-e HTTPS_PROXY只是一种请求而已。 - 限制允许访问的目标。仅允许访问
api.github.com这个主机。从该容器中窃取的凭证无法在其他地方使用,且无论是否成功,相关操作都会被记录在日志中。
--user 10001,通过--cap-drop ALL移除所有能力,添加--security-opt no-new-privileges,并以--read-only模式挂载文件系统,同时使用tmpfs作为临时文件存储空间。/key.pem:ro,不设置工作空间。将$HOME绑定到容器中并不算真正的沙箱隔离。--toolsets排除某些工具组,再利用--exclude-tools进一步删减剩余工具,使该服务器的可用工具从42个减少到37个,其中仍有15个工具具备写入权限。latest,也避免使用版本标签,因为标签可能会被重新指向。此设置中的所有图像,包括代理图像,都使用@sha256:…格式,因此其内容不会被更改。并没有单一规则能决定是否会发生损害。被篡改的文档仍可能诱使代理执行工具调用。每条规则仅限制攻击的扩散范围,且没有任何规则能锁定触发条件。沙箱只规定程序可以在何处进行操作,而不限制其操作内容。
允许列表仅能界定范围——它能确认流量确实发往 api.github.com,却无法揭示内容信息。contents: write 允许代理推送分支,同时也允许注入的指令提交文件。分支名称、提交信息以及问题标题单独来看似乎并无问题,但组合在一起却可能将任何内容偷偷带入他人可读取的仓库中。只要过滤规则足够宽松让代理正常工作,数据就有可能泄露,因为代理的操作本质上就是在 GitHub 上进行读写。
因此应将这一切视为起点而非终点,先完成这一步。其代价是七个问题、大约十分钟的阅读时间以及一次 tools/list 调用。作为回报,你会得到一个可防护的配置文件,而此前只是盲目粘贴了三行代码而已。
相关阅读
- 保护支持写入功能的MCP工具:超越令牌的七层防护机制 — 为何MCP令牌无法授权后续写入操作,以及能够实现这一功能的七层控制机制、凭据分离机制、精确请求审批机制和重试规则。
- 实用指南:微软构建了Playwright MCP服务器,然后要求大家这样做 — 对《实用指南:微软构建了Playwright MCP服务器,然后要求大家这样做》的详细操作指引:包括相关契约、检查项,以及供采用该模式的团队直接使用的代码模板。