🚀 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 数据提取器服务器的功能，并根据需求进行定制开发。