源映射文件解析器

🌐 语言: English | 简体中文

该项目实现了一个基于 WebAssembly 的源映射文件解析器，能够将 JavaScript 错误堆栈跟踪映射回源代码，并提取相关信息。开发者可以轻松地将 JavaScript 错误堆栈跟踪映射回源代码，从而快速定位和解决问题。本文档旨在帮助开发人员更好地理解和使用此工具。

MCP 集成

注意：需要 Node.js 18+ 支持

选项 1：直接通过 NPX 运行

npx -y source-map-parser-mcp@latest

选项 2：下载构建产物

从 GitHub 发布 页面下载相应版本的构建产物，然后运行：

node dist/main.es.js

运行时参数配置

系统运行时参数可以通过环境变量灵活配置，以满足不同场景的需求。

• SOURCE_MAP_PARSER_RESOURCE_CACHE_MAX_SIZE：设置资源缓存占用的最大内存空间，默认为 200MB。调整此值可以平衡性能和内存使用。
• SOURCE_MAP_PARSER_CONTEXT_OFFSET_LINE：定义在错误位置周围显示的上下文代码行数，默认为 1 行。增加此值可提供更多上下文信息，便于问题诊断。

示例：

# 设置 500MB 缓存并显示 3 行上下文
export SOURCE_MAP_PARSER_RESOURCE_CACHE_MAX_SIZE=500
export SOURCE_MAP_PARSER_CONTEXT_OFFSET_LINE=3
npx -y source-map-parser-mcp@latest

内部逻辑概述

1. 主文件描述

• stack_parser_js_sdk.js：WebAssembly 模块的 JavaScript 包装器，提供核心堆栈解析功能。
• parser.ts：解析器的主要实现，负责初始化 WebAssembly 模块、获取源映射内容以及解析堆栈信息。
• server.ts：MCP 服务器的实现，提供 parse_stack 工具接口供外部调用。

2. 修改解析逻辑

要修改解析逻辑，请编辑 parser.ts 文件中的 getSourceToken 方法。

3. 添加新工具

在 server.ts 文件中，可以通过 server.tool 方法添加新的工具接口。

注意事项

1. 源映射文件：请确保提供的源映射文件地址可访问且格式正确。
2. 错误处理：在解析过程中可能会遇到网络错误、文件格式错误等问题；建议在调用时实现适当的错误处理机制。

贡献指南

欢迎通过 Issues 和 Pull Requests 为该项目做出贡献，以改进它。

许可证

本项目licensed under the MIT License。更多细节请参阅 LICENSE 文件。