Source Map Parser

🚀 ソースマップファイル解析器

このプロジェクトは、WebAssembly ベースのソースマップファイル解析器を実装しています。JavaScript のエラースタックトレースをソースコードにマッピングし、関連情報を抽出することができます。開発者は、JavaScript のエラースタックトレースを簡単にソースコードにマッピングし、問題を迅速に特定して解決することができます。このドキュメントは、開発者がこのツールをよりよく理解して使用するのを支援することを目的としています。

🚀 クイックスタート

このソースマップファイル解析器を使用することで、JavaScript のエラースタックトレースをソースコードにマッピングし、問題を迅速に特定できます。以下に具体的な使い方を説明します。

✨ 主な機能

• ソースマップファイルの解析を通じて、JavaScript のエラースタックトレースをソースコードにマッピングする。
• 解析に必要なパラメータを環境変数で柔軟に設定できる。
• MCP サーバーとの統合をサポートし、外部からの呼び出しが可能。

📦 インストール

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 メソッドを使用して新しいツールインターフェースを追加できます。

📚 ドキュメント

注意事項

⚠️ 重要提示

• 提供するソースマップファイルのアドレスがアクセス可能で、形式が正しいことを確認してください。
• 解析中にネットワークエラーやファイル形式エラーなどの問題が発生する可能性があります。呼び出し時に適切なエラー処理メカニズムを実装することをお勧めします。

貢献ガイド

このプロジェクトへの貢献は、Issues や Pull Requests を通じて歓迎されます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。