Source Map Parser

基本能力

产品定位

source-map-parser-mcp 是一个开发工具，旨在帮助开发者通过解析 JavaScript 错误堆栈跟踪和 Source Map 文件，快速定位和修复代码问题。

核心功能

1. 堆栈跟踪解析：根据提供的行号、列号和 Source Map 文件解析对应的源代码位置。
2. 批量解析：支持同时解析多个堆栈跟踪并返回批量结果。
3. 上下文提取：提取指定数量的上下文行，帮助开发者更好地理解错误发生的环境。

适用场景

1. 错误调试：在开发或生产环境中，快速定位 JavaScript 错误的具体位置。
2. 代码审查：通过堆栈跟踪和上下文信息，更好地理解代码执行流程。
3. 自动化测试：在自动化测试中，快速定位测试失败的原因。

工具列表

1. operating_guide：获取 MCP 服务的使用指南，提供交互式的方式了解如何使用 MCP 服务。
2. parse_stack：解析堆栈跟踪信息和 Source Map URL。

常见问题解答

1. WebAssembly 模块加载失败：
2. 确保 Node.js 版本为 18 或更高。
3. 如果问题仍然存在，使用以下命令启动工具： bash npx --node-arg=--experimental-wasm-reftypes -y source-map-parser-mcp@latest

使用教程

使用依赖

确保已安装 Node.js 18+ 和 npm。

安装教程

运行以下命令安装项目依赖：

npm install

调试方式

运行以下命令启动 MCP 服务器：

npx tsx src/main.ts

高级用法

对于安全或性能原因，某些团队可能不希望直接将 Source Maps 暴露给浏览器进行解析。可以通过提示规则完成路径转换。

本地开发指南

1. 安装依赖： bash npm install
2. 启动 MCP 服务： bash npx tsx src/main.ts
3. 修改解析逻辑：编辑 parser.ts 文件中的 getSourceToken 方法。
4. 添加新工具：在 server.ts 文件中使用 server.tool 方法添加新工具接口。

注意事项

1. Source Map 文件：确保提供的 Source Map 文件 URL 可访问且文件格式正确。
2. 上下文行数：调整 ctxOffset 参数以控制提取的上下文行数。
3. 错误处理：在调用工具时适当处理可能遇到的错误。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。