Node Omnibus MCP Server

Instructions

Implementation Reference

• src/index.ts:884-913 (handler)

  The handler function that executes the add_script tool: validates the project path, reads package.json, adds the new script, writes it back, and returns success message.

  private async handleAddScript(args: AddScriptArgs) {
      await this.validatePath(args.path);
  
      try {
          const packageJsonPath = path.join(args.path, 'package.json');
          const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));
  
          if (!packageJson.scripts) {
              packageJson.scripts = {};
          }
  
          packageJson.scripts[args.name] = args.command;
  
          await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
  
          return {
              content: [
                  {
                      type: 'text',
                      text: `Added script '${args.name}': ${args.command}`,
                  },
              ],
          };
      } catch (error) {
          throw new McpError(
              ErrorCode.InternalError,
              `Failed to add script: ${error instanceof Error ? error.message : String(error)}`
          );
      }
  }

• src/index.ts:55-59 (schema)

  TypeScript interface defining the expected input arguments for the add_script tool: path (project directory), name (script name), command (script command).

  interface AddScriptArgs extends Record<string, unknown> {
      path: string;
      name: string;
      command: string;
  }

• src/index.ts:324-345 (registration)

  Registration of the add_script tool in the ListToolsRequestSchema handler, providing name, description, and JSON schema for input validation.

  {
      name: 'add_script',
      description: 'Add a new npm script to package.json',
      inputSchema: {
          type: 'object',
          properties: {
              path: {
                  type: 'string',
                  description: 'Project directory path',
              },
              name: {
                  type: 'string',
                  description: 'Script name',
              },
              command: {
                  type: 'string',
                  description: 'Script command',
              },
          },
          required: ['path', 'name', 'command'],
      },
  },

• src/index.ts:403-404 (registration)

  Dispatch registration in the CallToolRequestSchema switch statement that calls the handleAddScript function when 'add_script' is invoked.

  case 'add_script':
      return await this.handleAddScript(args as AddScriptArgs);