基本能力
产品定位
source-map-parser-mcp 是一个开发工具,旨在帮助开发者通过解析 JavaScript 错误堆栈跟踪和 Source Map 文件,快速定位和修复代码问题。
核心功能
- 堆栈跟踪解析:根据提供的行号、列号和 Source Map 文件解析对应的源代码位置。
- 批量解析:支持同时解析多个堆栈跟踪并返回批量结果。
- 上下文提取:提取指定数量的上下文行,帮助开发者更好地理解错误发生的环境。
适用场景
- 错误调试:在开发或生产环境中,快速定位 JavaScript 错误的具体位置。
- 代码审查:通过堆栈跟踪和上下文信息,更好地理解代码执行流程。
- 自动化测试:在自动化测试中,快速定位测试失败的原因。
工具列表
operating_guide
:获取 MCP 服务的使用指南,提供交互式的方式了解如何使用 MCP 服务。parse_stack
:解析堆栈跟踪信息和 Source Map URL。
常见问题解答
- WebAssembly 模块加载失败:
- 确保 Node.js 版本为 18 或更高。
- 如果问题仍然存在,使用以下命令启动工具:
bash
npx --node-arg=--experimental-wasm-reftypes -y source-map-parser-mcp@latest
使用教程
使用依赖
确保已安装 Node.js 18+ 和 npm。
安装教程
运行以下命令安装项目依赖:
bash
npm install
调试方式
运行以下命令启动 MCP 服务器:
bash
npx tsx src/main.ts
高级用法
对于安全或性能原因,某些团队可能不希望直接将 Source Maps 暴露给浏览器进行解析。可以通过提示规则完成路径转换。
本地开发指南
- 安装依赖:
bash
npm install - 启动 MCP 服务:
bash
npx tsx src/main.ts - 修改解析逻辑:编辑
parser.ts
文件中的getSourceToken
方法。 - 添加新工具:在
server.ts
文件中使用server.tool
方法添加新工具接口。
注意事项
- Source Map 文件:确保提供的 Source Map 文件 URL 可访问且文件格式正确。
- 上下文行数:调整
ctxOffset
参数以控制提取的上下文行数。 - 错误处理:在调用工具时适当处理可能遇到的错误。