search_repositories
Find GitHub repositories using advanced search queries, pagination, and customizable result limits.
Instructions
Search for GitHub repositories
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (default: 1) | |
| perPage | No | Number of results per page (default: 30, max: 100) | |
| query | Yes | Search query (see GitHub search syntax) |
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) }], }; }