mcp-server/plopfile.cjs at main · mapbox/mcp-server · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
/**
 * Plop generator for creating new MCP tools.
 *
 * Usage:
 *   Interactive mode (requires TTY):
 *     npx plop create-tool
 *
 *   Non-interactive mode (for CI, scripts, or non-TTY environments):
 *     npx plop create-tool "ToolName" "tool_name_tool"
 *
 * Example:
 *   npx plop create-tool "Search" "search_tool"
 *
 * This generates:
 *   - src/tools/search-tool/SearchTool.ts
 *   - src/tools/search-tool/SearchTool.input.schema.ts
 *   - src/tools/search-tool/SearchTool.output.schema.ts
 *   - test/tools/search-tool/SearchTool.test.ts
 *   - Updates src/tools/toolRegistry.ts
 *   - Updates README.md
 */
module.exports = function (plop) {
    plop.setGenerator('create-tool', {
        description: 'Generate a TypeScript class and its test',
        prompts: [
            {
                type: 'input',
                name: 'name',
                message: 'Tool class name without suffix using PascalCase e.g. Search:',
            },
            {
                type: 'input',
                name: 'toolName',
                message: 'Tool name property in snake_case. Must end with _tool e.g. search_tool:',
            },
        ],
        actions: [
            {
                type: 'add',
                path: 'src/tools/{{kebabCase name}}-tool/{{pascalCase name}}Tool.ts',
                templateFile: 'plop-templates/tool.hbs',
            },
            {
                type: 'add',
                path: 'test/tools/{{kebabCase name}}-tool/{{pascalCase name}}Tool.test.ts',
                templateFile: 'plop-templates/tool.test.hbs',
            },
            {
                type: 'add',
                path: 'src/tools/{{kebabCase name}}-tool/{{pascalCase name}}Tool.input.schema.ts',
                templateFile: 'plop-templates/tool.input.schema.hbs',
            },
            {
                type: 'add',
                path: 'src/tools/{{kebabCase name}}-tool/{{pascalCase name}}Tool.output.schema.ts',
                templateFile: 'plop-templates/tool.output.schema.hbs',
            },
            {
                type: 'append',
                path: 'src/tools/toolRegistry.ts',
                pattern: /(\/\/ INSERT NEW TOOL IMPORT HERE)/,
                template: "import { {{pascalCase name}}Tool } from './{{kebabCase name}}-tool/{{pascalCase name}}Tool.js';",
            },
            {
                type: 'append',
                path: 'src/tools/toolRegistry.ts',
                pattern: /(\/\/ INSERT NEW TOOL INSTANCE HERE)/,
                template: '  new {{pascalCase name}}Tool({ httpRequest }),',
            },
            {
                type: 'append',
                path: 'README.md',
                pattern: /(### Mapbox API tools)/,
                template: '\n\n#### {{titleCase name}} tool\n\nDescription goes here...\nUses the *Link to Mapbox API documentation here*',
            },
        ],
    });
};