Source Map Parser - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

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。

安装教程

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

bash
npm install

调试方式

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

bash
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. 错误处理：在调用工具时适当处理可能遇到的错误。