Nightjar MCP Server

Nightjar MCP服务器

用于分析Adobe Launch/Tags实现和嵌入代码的模型上下文协议（MCP）服务器。

特性

• 解析Adobe Launch嵌入代码以提取规则、数据元素和变量
• 分析规则、数据元素和变量，以了解其目的和配置
• 从网站URL中提取嵌入代码
• AI驱动的实现组件分析（使用OpenAI API密钥）
• 与Claude Desktop和其他MCP客户端无缝协作

最近修复

• 增强的规则解析：完全重新设计了规则解析逻辑，使用直接模式匹配从Adobe Launch嵌入代码中可靠地提取规则。
• 稳健提取算法：现在使用目标模式识别通过ID和名称模式查找规则，即使在复杂的启动配置下也能确保可靠的提取。
• 改进的数据捕获：更好地提取规则事件、条件、操作和自定义代码。
• 增强调试：添加了用于故障排除和诊断的详细日志记录。

安装

快速安装

运行安装程序脚本：

curl -sSL https://raw.githubusercontent.com/yourusername/nightjar-mcp-server/main/install.sh | bash

手动安装

全局安装软件包：

npm install -g nightjar-mcp-server

使用Claude Desktop

安装后，服务器将在您的Claude Desktop配置中注册。

1. 重新启动克劳德桌面
2. 请Claude分析Adobe Launch实现：

- “你能分析一下这个Adobe Launch嵌入代码吗：https://assets.adobedtm.com/launch-..." - “本网站的Adobe Launch实施中有哪些规则：https://example.com" - “分析此嵌入代码中的‘addToArt’规则：https://assets.adobedtm.com/launch-..."

命令行选项

nightjar-mcp-server [options]

Options:
  --openai-api-key   OpenAI API Key for AI-powered analysis
  --debug                    Enable debug mode for verbose logging
  --help                     Display help information

工具功能

Nightjar MCP服务器提供以下工具：

1. 解析器嵌入代码 -直接解析Adobe Launch嵌入代码

- 输入：Adobe启动嵌入代码URL（例如。，https://assets.adobedtm.com/launch-...)

1. parse_embed_from_url -从网站URL提取并解析Adobe Launch嵌入代码

- 输入：网站URL（例如。，https://www.example.com)

1. 分析规则 -从解析的嵌入代码中分析特定规则

- 输入：规则名称、可选嵌入代码、AI分析标志

1. 分析数据元素 -从解析的嵌入代码中分析特定的数据元素

- 输入：数据元素名称、可选嵌入代码、AI分析标志

1. 分析变量 -分析Adobe Analytics变量在规则中的使用方式

- 输入：变量名称（例如eVar1、prop5、event10）、可选嵌入代码和AI分析标志

1. list_rules -列出Adobe Launch嵌入代码中的所有规则

- 输入：可选嵌入代码

1. list_data_elements -列出Adobe Launch嵌入代码中的所有数据元素

- 输入：可选嵌入代码

1. list_变量 -列出启动嵌入代码中使用的所有Adobe Analytics变量

- 输入：可选嵌入代码

例子

基本用法

# Parse an embed code
parse_embed_code:
  embed_code: "https://assets.adobedtm.com/launch-EN12345.min.js"

# Extract and parse from a URL
parse_embed_from_url:
  url: "https://www.example.com"

# List all rules
list_rules:
  # No parameters needed if you've already parsed an embed code

# Analyze a specific rule
analyze_rule:
  rule_name: "pageLoad"
  use_ai: true

人工智能高级分析

对于使用AI的增强分析（需要OpenAI API密钥）：

# Start the server with OpenAI API key
nightjar-mcp-server --openai-api-key YOUR_API_KEY

# Then in Claude, request AI-powered analysis
analyze_rule:
  rule_name: "addToCart"
  use_ai: true

测试

要运行测试，请执行以下操作：

# Test rule extraction with the new approach
node extract-rules.js

# Test the updated NightjarClient implementation
node test-new-approach.js

# Run the original test script
node test-rule-analysis.js

故障排除

如果您在规则解析或其他功能方面遇到问题：

1. 以调试模式运行： nightjar-mcp-server --debug
2. 检查日志中的错误或警告
3. 验证嵌入代码URL是否有效且可访问
4. 使用附带的测试脚本进行测试，以验证功能

发展

贡献或定制：

1. 克隆存储库
2. 安装依赖项： npm install
3. 运行测试： npm test
4. 对于调试，请使用专用的测试脚本

技术细节

规则解析的工作原理

Nightjar MCP服务器使用完全重新设计的方法从Adobe Launch嵌入代码中提取规则：

1. 使用嵌入代码URL获取启动文件
2. 使用直接模式匹配根据规则的ID和名称模式查找规则
3. 为每个匹配的规则提取完整的规则上下文
4. 从上下文中解析规则组件（事件、条件、动作等）
5. 创建用于分析的规则的结构化表示

这种新方法比以前的方法更稳健可靠，以前的方法依赖于复杂的字符串分割，并且很容易因不同的Launch配置而中断。

建筑

服务器由两个主要组件组成：

1. NightjarClient类：处理Adobe Launch嵌入代码的解析和分析
2. MCP服务器：通过模型上下文协议公开Nightjar功能

许可证

麻省理工学院