Data Extractor

🚀 MCP Data Extractor Server Documentation

The MCP Data Extractor Server can extract strings and template literals from TypeScript or JavaScript source code and supports handling complex structures (such as arrays and objects). Here are the main features:

• String Value Extraction: Identify and extract string literals and template literals.
• Complex Structure Support: Handle arrays and objects, supporting nested structures.
• Custom Extension: Allow supporting more AST node types by extending the extractStringValue and processValue methods.

✨ Features

String Value Extraction

It can recognize and extract string literals and template literals.

Complex Structure Support

It can handle arrays and objects, and support nested structures.

Custom Extension

It allows users to support more AST node types by extending the extractStringValue and processValue methods.

💻 Usage Examples

Basic Usage

Input

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

Output

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

Advanced Usage

Input

export default {
  header: {
    title: '欢迎使用',
    description: `这是一个示例 ${description}`
  },
  list: ['项目1', '项目2', { id: '3' }]
};

Output

{
  "header.title": "欢迎使用",
  "header.description": "这是一个示例 {{description}}",
  "list.0": "项目1",
  "list.1": "项目2",
  "list.2.id": "3"
}

📚 Documentation

Adding New AST Node Types

To extend the supported node types, you can modify the extractStringValue method in src/index.ts:

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('{{}}');
  }
  // Add support for new node types
  if (t.isSome newNodeType(node)) {
    // Handle the new node type
  }
  return null;
}

Custom Value Processing

By overriding the processValue method, you can extend the processing of other value types:

private processValue(value: t.Node, currentPath: string[]): void {
  if (t.isStringLiteral(value) || t.isTemplateLiteral(value)) {
    // Process string values
  } else if (t.isArrayExpression(value)) {
    // Process arrays
  } else if (t.isObjectExpression(value)) {
    // Process objects
  }
  // Add processing for new value types
}

Custom AST Traversal

You can extend the AST traversal function by adding custom visitors:

traverse(ast, {
  ExportDefaultDeclaration(path: NodePath<t.ExportDefaultDeclaration>) {
    // Process default exports
  },
  // Add new visitors
});

📦 Installation

Install Dependencies

npm install

Build the Server

npm run build

Development Mode (Automatic Rebuild)

npm run watch

🐞 Debugging Guide

Since the MCP server communicates through standard input and output, debugging can be difficult. We recommend using MCP Inspector for debugging:

npm run inspector

The Inspector provides a web interface to help you debug and analyze code.

📄 License

This project is licensed under the MIT License. Please see the LICENSE file for details.

With the above instructions, you can easily extend the functionality of the MCP Data Extractor Server and perform customized development according to your needs.