Source Map Parser

🚀 源映射文件解析器

該項目實現了一個基於 WebAssembly 的源映射文件解析器，可將 JavaScript 錯誤堆棧跟蹤映射回源代碼，並提取相關信息。開發者能借此快速定位和解決問題。本文檔將幫助開發人員更好地理解和使用此工具。

🚀 快速開始

MCP 集成

⚠️ 重要提示

需要 Node.js 18+ 支持

選項 1：直接通過 NPX 運行

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

選項 2：下載構建產物

從 GitHub 發佈 頁面下載相應版本的構建產物，然後運行：

node dist/main.es.js

運行時參數配置

💡 使用建議

系統運行時參數可以通過環境變量靈活配置，以滿足不同場景的需求。

示例：

# 設置 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 為該項目做出貢獻，以改進它。

📄 許可證

本項目採用 MIT 許可證。更多細節請參閱 LICENSE 文件。