JinDaGe - source-map-parser-mcp MCP Details

article

README

🚀 源映射解析器

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

🚀 快速开始

该项目支持两种语言版本，可按需选择： 🌐 语言: English | 简体中文

📦 安装指南

MCP集成

⚠️ 重要提示

需要Node.js 18+版本支持

选项1：直接通过NPX运行

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

选项2：下载构建产物

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

node dist/main.es.js

运行时参数配置

使用以下环境变量来配置解析器的行为：

SOURCE_MAP_PARSER_API_KEY：用于身份验证的API密钥。
SOURCE_MAP_PARSER_CACHE_ENABLED：控制缓存功能（值为true或false）。

✨ 主要特性

初始化WebAssembly模块：通过JavaScript包装器加载和实例化WebAssembly模块，确保其正确运行。
源映射内容检索：从指定的URL获取源映射文件内容，并进行必要的验证。
堆栈信息解析：将错误堆栈追踪中的每个位置信息解析为目标源代码的位置。

💻 使用示例

核心接口

parse_stack：解析给定的错误堆栈字符串，返回解析后的结果。

基础用法

const result = await parse_stack({
  stack: /* 错误堆栈字符串 */,
  options: {
    cacheProvider: /* 缓存提供者实例 */,
    sourceMapCacheEnabled: true,
    apiKey: 'your_api_key'
  }
});

🔧 技术细节

高级用法

自定义解析逻辑

在parser.ts文件中，可以通过重写getSourceToken方法来实现自定义的解析逻辑。

扩展工具接口

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

📚 详细文档

常见问题解答

1. WebAssembly模块初始化失败

如果遇到以下错误信息：

parser init error: WebAssembly.instantiate(): invalid value type 'externref', enable with --experimental-wasm-reftypes @+86

请按照以下步骤排查：

检查Node.js版本：确保Node.js版本为18或更高。如果低于18，请升级Node.js。
启用实验性标志：如果使用的是Node.js 18+但仍然遇到问题，可以使用以下命令启动工具：

npx --node-arg=--experimental-wasm-reftypes -y source-map-parser-mcp@latest

本地开发指南

安装依赖项

确保已安装Node.js和npm，然后运行以下命令安装项目依赖：

npm install

链接MCP服务

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

npx tsx src/main.ts

注意事项

⚠️ 重要提示

请确保提供的源映射文件地址可访问且格式正确。

💡 使用建议

在解析过程中可能会遇到网络错误、文件格式错误等问题，建议在调用时进行适当的错误处理。

贡献指南

欢迎通过Issues和Pull Requests为该项目做出贡献。

📄 许可证

本项目使用MIT许可证。更多细节请参见LICENSE文件。

source-map-parser-mcp