Git Repo Browser MCP

Instructions

Implementation Reference

• src/handlers/directory-operations.js:48-89 (handler)

  Core handler function that implements the git_read_files tool logic: clones the repository, reads specified files, and returns their contents as JSON.

  export async function handleGitReadFiles({ repo_url, file_paths }) {
    try {
      const repoPath = await cloneRepo(repo_url);
      const results = {};
  
      for (const filePath of file_paths) {
        const fullPath = path.join(repoPath, filePath);
        try {
          if (await fs.pathExists(fullPath)) {
            results[filePath] = await fs.readFile(fullPath, "utf8");
          } else {
            results[filePath] = "Error: File not found";
          }
        } catch (error) {
          results[filePath] = `Error reading file: ${error.message}`;
        }
      }
  
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(results, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(
              { error: `Failed to process repository: ${error.message}` },
              null,
              2
            ),
          },
        ],
        isError: true,
      };
    }
  }

• src/server.js:109-129 (schema)

  Input schema definition for the git_read_files tool, specifying parameters repo_url and file_paths.

  {
    name: "git_read_files",
    description:
      "Read the contents of specified files in a given git repository.",
    inputSchema: {
      type: "object",
      properties: {
        repo_url: {
          type: "string",
          description: "The URL of the Git repository",
        },
        file_paths: {
          type: "array",
          items: { type: "string" },
          description:
            "List of file paths to read (relative to repository root)",
        },
      },
      required: ["repo_url", "file_paths"],
    },
  },

• src/server.js:901-901 (registration)

  Maps the tool name 'git_read_files' to its handler function handleGitReadFiles in the central handlersMap.

  git_read_files: handleGitReadFiles,

• src/handlers/index.js:44-44 (registration)

  Re-exports the handleGitReadFiles function from directory-operations.js for use in server.js.

  handleGitReadFiles,