srcmap mcp
](https://www.npmjs.com/package/srcmap-mcp)  ](https://nodejs.org/)   
用于源映射调试的MCP服务器。直接从您的人工智能助手从任何生产网站获取、检查、查找和提取原始来源。
添加到编辑器
克劳德代码
claude mcp add srcmap-mcp -- npx srcmap-mcpCodex CLI
codex --mcp-config '{"srcmap-mcp":{"command":"npx","args":["srcmap-mcp"]}}'Gemini CLI
gemini --mcp-config '{"srcmap-mcp":{"command":"npx","args":["srcmap-mcp"]}}'VS Code
添加 .vscode/mcp.json:
{
"servers": {
"srcmap-mcp": {
"command": "npx",
"args": ["srcmap-mcp"]
}
}
}Claude Desktop / Windsurf / Cline / Zed / Docker
克劳德桌面/风帆/克莱恩
添加到MCP配置文件中：
{
"mcpServers": {
"srcmap-mcp": {
"command": "npx",
"args": ["srcmap-mcp"]
}
}
}泽德
添加到Zed设置：
{
"context_servers": {
"srcmap-mcp": {
"command": {
"path": "npx",
"args": ["srcmap-mcp"]
}
}
}
}码头工人
docker run -i --rm ghcr.io/bartwaardenburg/srcmap-mcp先决条件
此MCP服务器需要 srcmap 要安装的CLI：
cargo install srcmap-cli验证它是否可用：
srcmap --version特性
8工具 跨3个类别进行完整的源代码映射调试：
检查（4个工具）
| 工具 | 说明 |
|---|---|
sourcemap_info | 显示源地图元数据和统计信息 |
sourcemap_validate | 验证源映射文件 |
sourcemap_sources | 列出源映射中的所有原始源文件 |
sourcemap_mappings | 具有分页和源筛选的列表映射 |
查找（2个工具）
| 工具 | 说明 |
|---|---|
sourcemap_lookup | 使用源上下文为生成的位置查找原始位置 |
sourcemap_resolve | 反向查找：查找原始位置的生成位置 |
提取（2个工具）
| 工具 | 说明 |
|---|---|
sourcemap_fetch | 从URL下载捆绑包及其源映射 |
sourcemap_extract_sources | 将所有嵌入的原始源提取到磁盘 |
配置
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
SRCMAP_BINARY | 没有 | srcmap | srcmap CLI二进制文件的路径 |
SRCMAP_CACHE_TTL | 没有 | 300 | 缓存TTL（秒）（0表示禁用） |
SRCMAP_TOOLSETS | 否 | 全部 | 启用逗号分隔的工具集 |
工具集筛选
| 工具集 | 工具 | 说明 |
|---|---|---|
inspection | 4 | 源映射元数据、验证、源列表、映射 |
lookup | 2 | 正向和反向位置查找 |
fetch | 2 | 远程获取和源提取 |
例子： SRCMAP_TOOLSETS=lookup,fetch 仅启用查找和获取工具。
示例用法
调试生产错误
哨兵正在显示TypeError: Cannot read property 'items' of undefined在main-2f8a.js:1:34291上https://app.example.com--原始来源是什么？
助手获取包和源映射，查找位置，并向您显示导致错误的确切原始文件和行以及周围的上下文。
调查部署的内容
实际运行的代码是什么https://app.example.com?提取源树，以便我们可以四处查看。
助手拉取制作包，提取所有原始来源，并为您提供完整的项目结构以供探索。
从堆栈跟踪中跟踪错误
用户在我们的结账页面上报告了崩溃。这是缩小的堆栈跟踪——你能将每一帧追溯到原始源吗？ `` at https://cdn.example.com/checkout-a3f2.js:1:48293 at https://cdn.example.com/checkout-a3f2.js:1:51007 at https://cdn.example.com/vendor-9b1e.js:1:12844 ``助手将每一帧解析为原始文件、函数名和行号，将一堵缩小的位置墙变成可读的堆栈跟踪。
发展
pnpm install # Install dependencies
pnpm dev # Run in development mode
pnpm build # Compile TypeScript
pnpm test # Run tests
pnpm typecheck # Type check without emitting项目结构
src/
index.ts Entry point (env, client, transport)
server.ts McpServer factory and toolset registry
srcmap-client.ts CLI process wrapper with caching
cache.ts TTL cache
tool-result.ts Result/error formatting helpers
update-checker.ts npm update checker
types.ts TypeScript interfaces
tools/
inspection.ts Info, validate, sources, mappings tools
lookup.ts Lookup and resolve tools
fetch.ts Fetch and extract tools
tools.test.ts Tool handler tests需求
- Node.js>=20
srcmap已安装CLI(cargo install srcmap-cli)
许可证
麻省理工学院