VS代码MCP LSP网关
一个VS Code扩展， 只读的 VS Code的语言智能子集（类似LSP的功能）作为MCP工具 可流式传输的HTTP，专为硬上限下的确定性故障关闭操作而设计。
快速入门（VS代码+Codex IDE扩展）
1） 安装+信任工作区（VS代码）
- 安装此扩展。
- 打开目标工作区。
- 确保工作空间 可信的 （默认情况下，限制模式将阻止服务器启动）。
2） 启用网关（VS代码）
设置：
mcpLspGateway.enabled = true
默认设置是有意严格的（仅限本地主机，启用会话，服务器超时时间小）；看见 配置 在......下面
3） 提供和管理不记名代币（VS代码）
使用命令选项板：
- MCP LSP网关：设置承载令牌 （建议用于显式旋转）
- MCP LSP网关：清除承载令牌
令牌存储在VS Code SecretStorage中（不在设置中）。如果没有令牌，网关在启动时会在SecretStorage中自动配置一个令牌，您可以通过“CopyCodexconfig.toml”命令检索它。
4） 配置Codex IDE扩展以使用此MCP服务器（Codex config.toml）
Codex（CLI和IDE扩展）从以下位置读取MCP服务器 ~/.codex/config.tomlCLI和IDE扩展共享同一个文件。
要从Codex IDE扩展名打开文件，请执行以下操作：
- 打开Codex面板，选择齿轮图标，然后选择 Codex设置>打开config.toml （在某些视图中，它可能出现在MCP设置下）。
现在为此网关添加一个条目。你有两个实际的选择：
选项A（最简单）：配置中的内联令牌
使用此扩展的命令面板辅助工具：
- MCP LSP网关：复制Codex config.toml（令牌内联）
将生成的节粘贴到 ~/.codex/config.toml.
选项B（推荐）：将令牌从文件中删除
Codex支持流式HTTP MCP服务器 bearer_token_env_var （或 env_http_headers)所以秘密可能来自环境。
示例节：
[mcp_servers.vscode_mcp_lsp_gateway]
url = "http://127.0.0.1:3939/mcp"
# Put the token in an environment variable, not in this file.
bearer_token_env_var = "MCP_LSP_GATEWAY_TOKEN"
# Required by this gateway’s transport contract.
http_headers = {
"MCP-Protocol-Version" = "2025-11-25",
"Accept" = "application/json, text/event-stream",
"Content-Type" = "application/json"
}
enabled = true
startup_timeout_sec = 10
tool_timeout_sec = 60注意：如果启用了会话（默认），服务器将返回 MCP-Session-Id 上 initialize 并且客户端必须在后续请求中回应它。
5） 安装并登录Codex IDE扩展（如果需要）
Codex的VS Code扩展可通过VS Code Marketplace获得，并与VS Code分支（Cursor、Windsurf）配合使用。Windows支持是实验性的；为了在Windows上获得最佳效果，请使用WSL工作区。
6） 在哪里查看日志（VS代码）
打开 View → 输出 并选择 “MCP LSP网关” 输出通道。
为什么存在
人工智能编码代理经常需要语义代码理解（定义、引用、符号、诊断）来导航和推理大型工作空间。VS Code已经通过其活跃的语言提供商获得了这些知识。
该网关通过严格受限的MCP工具界面公开该知识，因此代理可以直接查询语言功能，而无需广泛的“执行命令”或可编写的API。
主要财产
- 仅限本地主机：服务器绑定到
127.0.0.1并拒绝以其他方式开始。 - 强制认证：每个请求都需要
Authorization: Bearer. - 工作区/URI门控：仅
file:URI；请求和返回的位置仅限于允许的工作区根。 - 只读：无编辑，无重命名/applyWorkspaceEdit，无代码操作，无任意命令执行。
- 确定性输出：规范化+稳定排序+重复数据消除。
- 确定性分页：分页工具使用游标快照语义（“游标携带快照”）并确定地拒绝过时/过期的游标。
关于规范性契约（上限、模式、确定性规则）：请参见 docs/CONTRACT.md. 有关威胁模型和强制控制：请参阅 docs/SECURITY.md. 有关运输/生命周期要求：请参阅 docs/PROTOCOL.md.
刀具目录
这些工具通过MCP公开 tools/list 并援引 tools/call:
vscode.lsp.definitionvscode.lsp.references（分页）vscode.lsp.hovervscode.lsp.documentSymbolsvscode.lsp.workspaceSymbols（分页）vscode.lsp.diagnostics.documentvscode.lsp.diagnostics.workspace（分页）
配置
所有设置都位于 mcpLspGateway.*:
enabled（默认值：false)
bindAddress（默认值：127.0.0.1，强制执行）
port（默认值：3939)
endpointPath（默认值：/mcp，强制执行）
enableSessions（默认值：true)
allowedOrigins（默认值：[])
- 如果A Origin 标头存在，它必须与此满列表完全匹配。
additionalAllowedRoots（默认值：[])
- 将额外的文件系统根添加到工作区根分配列表中（安全关键；保持最小）。
maxItemsPerPage（默认值：200，硬边界）
maxResponseBytes（默认值：524288，硬边界）
requestTimeoutMs（默认值：2000，硬边界）
debugLogging（默认值：false)
secretStorageKey（默认值：mcpLspGateway.authTokens)
如果任何设置违反了v1不变量，服务器将关闭失败，无法启动。
安全说明
- 不要将承载令牌存储在存储库、票证、聊天记录、屏幕截图或提交的配置文件中。
- 更喜欢环境来源的代币（Codex
bearer_token_env_var)在可行的情况下。 - 保持
additionalAllowedRoots范围狭窄。避免使用像整个主目录这样的根目录。
看 docs/SECURITY.md 对于完整的威胁模型和可测试的不变量。
限制（v1中的故意限制）
file:仅URI（无其他方案）- 只读工具表面（无写入操作）
- 请求和响应被过滤到允许的根
- 超过上限时的硬上限和确定性故障
发展
看 AGENTS.md 用于存储库工作流指导和质量门。