Unrestricted Development MCP Server

Instructions

Implementation Reference

• src/tools/git.ts:454-456 (handler)

  The core handler function for the 'git_show' tool. It validates input using Zod schema and executes the 'git show' command via the executeGitCommand helper, returning formatted output or error.

  export async function gitShow(args: z.infer<typeof gitShowSchema>): Promise<ToolResponse> {
    return executeGitCommand(`git show ${args.commit}`, args.cwd);
  }

• src/tools/git.ts:197-200 (schema)

  Zod schema for input validation of the git_show tool parameters (commit and cwd). Used in the dispatch handler to parse arguments before calling the main function.

  export const gitShowSchema = z.object({
    commit: z.string().optional().default('HEAD').describe('Commit hash or reference to show'),
    cwd: z.string().optional().describe('Repository directory')
  });

• src/tools/git.ts:749-758 (registration)

  MCP tool registration definition in gitTools array, including name, description, and JSON inputSchema advertised to MCP clients.

  {
    name: 'git_show',
    description: 'Show details of a commit',
    inputSchema: {
      type: 'object',
      properties: {
        commit: { type: 'string', default: 'HEAD', description: 'Commit hash or reference to show' },
        cwd: { type: 'string', description: 'Repository directory' }
      }
    }

• src/index.ts:433-436 (registration)

  Dispatch handler in main MCP server that routes 'git_show' tool calls, validates args with schema, and invokes the gitShow implementation.

  if (name === 'git_show') {
    const validated = gitShowSchema.parse(args);
    return await gitShow(validated);
  }

• src/tools/git.ts:21-61 (helper)

  Shared helper function that executes git commands via child_process.exec, formats output as ToolResponse, and handles errors uniformly across all git tools.

  async function executeGitCommand(command: string, cwd?: string): Promise<ToolResponse> {
    try {
      const { stdout, stderr } = await execAsync(command, {
        cwd: cwd || process.cwd(),
        shell: '/bin/bash',
        maxBuffer: 10 * 1024 * 1024 // 10MB buffer
      });
  
      return {
        content: [
          {
            type: "text" as const,
            text: JSON.stringify({
              success: true,
              command: command,
              stdout: stdout.trim(),
              stderr: stderr.trim(),
              cwd: cwd || process.cwd()
            }, null, 2)
          }
        ]
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: "text" as const,
            text: JSON.stringify({
              success: false,
              command: command,
              stdout: error.stdout?.trim() || '',
              stderr: error.stderr?.trim() || error.message,
              exitCode: error.code || 1,
              cwd: cwd || process.cwd()
            }, null, 2)
          }
        ],
        isError: true
      };
    }
  }