fork_repository
Create a GitHub repository fork to your account or a specific organization with specified owner and repository details for efficient code management.
Instructions
Fork a GitHub repository to your account or specified organization
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organization | No | Optional: organization to fork to (defaults to your personal account) | |
| owner | Yes | Repository owner (username or organization) | |
| repo | Yes | Repository name |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"organization": {
"description": "Optional: organization to fork to (defaults to your personal account)",
"type": "string"
},
"owner": {
"description": "Repository owner (username or organization)",
"type": "string"
},
"repo": {
"description": "Repository name",
"type": "string"
}
},
"required": [
"owner",
"repo"
],
"type": "object"
}
Implementation Reference
- index.ts:108-112 (registration)Registration of the 'fork_repository' tool in the MCP server's listTools response, including name, description, and input schema reference.{ name: "fork_repository", description: "Fork a GitHub repository to your account or specified organization", inputSchema: zodToJsonSchema(repository.ForkRepositorySchema), },
- index.ts:169-175 (handler)MCP tool dispatcher case for 'fork_repository': validates input using the schema and delegates to the forkRepository implementation.case "fork_repository": { const args = repository.ForkRepositorySchema.parse(request.params.arguments); const fork = await repository.forkRepository(args.owner, args.repo, args.organization); return { content: [{ type: "text", text: JSON.stringify(fork, null, 2) }], }; }
- operations/repository.ts:19-23 (schema)Zod input schema for the fork_repository tool, defining parameters: owner, repo, and optional organization.export const ForkRepositorySchema = z.object({ owner: z.string().describe("Repository owner (username or organization)"), repo: z.string().describe("Repository name"), organization: z.string().optional().describe("Optional: organization to fork to (defaults to your personal account)"), });
- operations/repository.ts:51-65 (handler)Core implementation of the fork_repository tool: constructs the GitHub API URL for forking (with optional organization) and performs the POST request, parsing the forked repository response.export async function forkRepository( owner: string, repo: string, organization?: string ) { const url = organization ? `https://api.github.com/repos/${owner}/${repo}/forks?organization=${organization}` : `https://api.github.com/repos/${owner}/${repo}/forks`; const response = await githubRequest(url, { method: "POST" }); return GitHubRepositorySchema.extend({ parent: GitHubRepositorySchema, source: GitHubRepositorySchema, }).parse(response); }