GitHub MCP Server

Instructions

Implementation Reference

• operations/repository.ts:37-49 (handler)

  The core handler function that implements the search_repositories tool by constructing the GitHub API search URL, making the request, and parsing the response.

  export async function searchRepositories(
    query: string,
    page: number = 1,
    perPage: number = 30
  ) {
    const url = new URL("https://api.github.com/search/repositories");
    url.searchParams.append("q", query);
    url.searchParams.append("page", page.toString());
    url.searchParams.append("per_page", perPage.toString());
  
    const response = await githubRequest(url.toString());
    return GitHubSearchResponseSchema.parse(response);
  }

• operations/repository.ts:13-17 (schema)

  Zod schema defining the input parameters for the search_repositories tool.

  export const SearchRepositoriesSchema = z.object({
    query: z.string().describe("Search query (see GitHub search syntax)"),
    page: z.number().optional().describe("Page number for pagination (default: 1)"),
    perPage: z.number().optional().describe("Number of results per page (default: 30, max: 100)"),
  });

• index.ts:76-78 (registration)

  Registration of the search_repositories tool in the ListTools handler, specifying name, description, and input schema.

  name: "search_repositories",
  description: "Search for GitHub repositories",
  inputSchema: zodToJsonSchema(repository.SearchRepositoriesSchema),

• index.ts:337-347 (registration)

  Dispatch handler in the CallToolRequestSchema that parses arguments and invokes the searchRepositories function.

  case "search_repositories": {
    const args = repository.SearchRepositoriesSchema.parse(request.params.arguments);
    const results = await repository.searchRepositories(
      args.query,
      args.page,
      args.perPage
    );
    return {
      content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
    };
  }