Data Extractor

🚀 MCP 數據提取器服務器文檔

MCP 數據提取器服務器可從 TypeScript 或 JavaScript 源代碼裡提取字符串、模板字面量，還能處理複雜結構（像數組和對象）。下面為你詳細介紹其功能、使用示例、擴展方法、開發與調試指南以及許可證信息。

🚀 快速開始

MCP 數據提取器服務器能高效地從 TypeScript 或 JavaScript 代碼中提取所需的字符串和模板字面量，支持複雜結構處理，還可通過擴展方法滿足更多定製需求。

✨ 主要特性

• 字符串值提取：精準識別並提取字符串字面量和模板字面量。
• 複雜結構支持：有效處理數組和對象，支持嵌套結構。
• 自定義擴展：可通過擴展 extractStringValue 和 processValue 方法，支持更多 AST 節點類型。

💻 使用示例

基礎用法

字符串值提取

• 輸入

export default {
  greeting: 'Hello, {{username}}!',
  message: `Welcome to ${appName}`
};

• 輸出

{
  "greeting": "Hello, {{username}}!",
  "message": "Welcome to {{appName}}"
}

複雜結構處理

• 輸入

export default {
  header: {
    title: '歡迎使用',
    description: `這是一個示例 ${description}`
  },
  list: ['項目1', '項目2', { id: '3' }]
};

• 輸出

{
  "header.title": "歡迎使用",
  "header.description": "這是一個示例 {{description}}",
  "list.0": "項目1",
  "list.1": "項目2",
  "list.2.id": "3"
}

🔧 技術細節

添加新的 AST 節點類型

要擴展支持的節點類型，可在 src/index.ts 中修改 extractStringValue 方法：

private extractStringValue(node: t.Node): string | null {
  if (t.isStringLiteral(node)) {
    return node.value;
  } else if (t.isTemplateLiteral(node)) {
    return node.quasis.map(quasi => quasi.value.raw).join('{{}}');
  }
  // 添加新的節點類型支持
  if (t.isSome newNodeType(node)) {
    // 處理新節點類型
  }
  return null;
}

自定義值處理

通過重寫 processValue 方法，可擴展對其他值類型的處理：

private processValue(value: t.Node, currentPath: string[]): void {
  if (t.isStringLiteral(value) || t.isTemplateLiteral(value)) {
    // 處理字符串值
  } else if (t.isArrayExpression(value)) {
    // 處理數組
  } else if (t.isObjectExpression(value)) {
    // 處理對象
  }
  // 添加新的值類型處理
}

自定義 AST 遍歷

可通過添加自定義訪問者來擴展 AST 遍歷功能：

traverse(ast, {
  ExportDefaultDeclaration(path: NodePath<t.ExportDefaultDeclaration>) {
    // 處理默認導出
  },
  // 添加新的訪問者
});

📦 安裝指南

安裝依賴

npm install

構建服務器

npm run build

開發模式（自動重建）

npm run watch

💡 使用建議

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能較為困難。我們推薦使用 MCP Inspector 進行調試：

npm run inspector

Inspector 會提供一個 Web 界面，幫助你調試和分析代碼。

📄 許可證

本項目遵循 MIT 許可證。請查看 LICENSE 文件以獲取詳細信息。

通過以上說明，你可以輕鬆擴展 MCP 數據提取器服務器的功能，並根據需求進行定製開發。