mcp.json
MCP 客户端的配置文件,用于定义 MCP 服务器的启动命令、参数与环境变量
时间轴 (近 90 天)
在 mcp.json 中配置 MCP 服务器的路径参数必须使用绝对路径,因为 stdio 启动的子进程工作目录可能漂移导致相对路径失效。
各AI工具的MCP配置文件不同:Cursor写入mcp.json,VS Code写入用户目录下的mcp.json,Windsurf使用mcp.config.json,Codex使用config.toml,Gemini CLI使用settings.json。
在 Cursor 的 mcp.json 中,每个服务器条目通常包含 command、args、env 三个关键字段,分别指定要执行的程序、传给程序的参数和注入子进程的环境变量。
建议将 GitHub 令牌写入 mcp.json 条目的 env 块而非 args 参数,因为 args 中的内容可能被命令日志、进程列表或调试输出记录下来,而环境变量相对隔离。
mcp.json 属于本地配置文件,其中的令牌以明文形式存储,若将 .cursor 目录纳入版本控制或同步到云端,需先将该文件加入忽略列表。
把 GitHub 令牌从 mcp.json 中移出,改为在启动命令里引用系统环境变量或存放在操作系统密钥链中由脚本注入,可降低明文令牌风险。
全部知识事实 (6)
在 mcp.json 中配置 MCP 服务器的路径参数必须使用绝对路径,因为 stdio 启动的子进程工作目录可能漂移导致相对路径失效。
50%待验证各AI工具的MCP配置文件不同:Cursor写入mcp.json,VS Code写入用户目录下的mcp.json,Windsurf使用mcp.config.json,Codex使用config.toml,Gemini CLI使用settings.json。
50%待验证在 Cursor 的 mcp.json 中,每个服务器条目通常包含 command、args、env 三个关键字段,分别指定要执行的程序、传给程序的参数和注入子进程的环境变量。
50%待验证建议将 GitHub 令牌写入 mcp.json 条目的 env 块而非 args 参数,因为 args 中的内容可能被命令日志、进程列表或调试输出记录下来,而环境变量相对隔离。
50%待验证mcp.json 属于本地配置文件,其中的令牌以明文形式存储,若将 .cursor 目录纳入版本控制或同步到云端,需先将该文件加入忽略列表。
50%待验证把 GitHub 令牌从 mcp.json 中移出,改为在启动命令里引用系统环境变量或存放在操作系统密钥链中由脚本注入,可降低明文令牌风险。
50%