Source Map Parser

🚀 Source Map Parser

This project implements a WebAssembly-based source map parser that can map JavaScript error stack traces back to the original source code and extract relevant information. Developers can easily map JavaScript error stack traces back to the source code, enabling them to quickly locate and resolve issues. This document aims to help developers better understand and use this tool.

🚀 Quick Start

MCP Integration

⚠️ Important Note

Node.js 18+ is required.

Option 1: Run directly via NPX

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

Option 2: Download the build artifacts Download the corresponding version of the build artifacts from the GitHub Releases page, then run:

node dist/main.es.js

Runtime Parameter Configuration

💡 Usage Tip

System runtime parameters can be flexibly configured through environment variables to meet the needs of different scenarios.

• SOURCE_MAP_PARSER_RESOURCE_CACHE_MAX_SIZE: Sets the maximum memory space occupied by the resource cache, with a default of 200MB. Adjusting this value can balance performance and memory usage.
• SOURCE_MAP_PARSER_CONTEXT_OFFSET_LINE: Defines the number of lines of context code displayed around the error location, with a default of 1 line. Increasing this value can provide more context information for easier problem diagnosis.

Example:

# Set a 500MB cache and display 3 lines of context
export SOURCE_MAP_PARSER_RESOURCE_CACHE_MAX_SIZE=500
export SOURCE_MAP_PARSER_CONTEXT_OFFSET_LINE=3
npx -y source-map-parser-mcp@latest

🔧 Technical Details

Internal Logic Overview

1. Main File Descriptions

• stack_parser_js_sdk.js: A JavaScript wrapper for the WebAssembly module, providing core stack parsing functionality.
• parser.ts: The main implementation of the parser, responsible for initializing the WebAssembly module, retrieving source map content, and parsing stack information.
• server.ts: The implementation of the MCP server, providing the parse_stack tool interface for external calls.

2. Modifying the Parsing Logic

To modify the parsing logic, edit the getSourceToken method in the parser.ts file.

3. Adding New Tools

In the server.ts file, new tool interfaces can be added via the server.tool method.

📄 Notes

1. Source Map Files: Ensure that the provided source map file addresses are accessible and in the correct format.
2. Error Handling: Network errors, file format errors, etc., may occur during the parsing process. It is recommended to implement appropriate error handling mechanisms when making calls.

✨ Contribution Guidelines

Contributions to this project via Issues and Pull Requests are welcome to help improve it.

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.