create_project
Automate the creation of a new project in a GitHub repository by specifying the owner, repository name, and project details. Simplify repository management with structured project setup.
Instructions
Create a new project in a GitHub repository
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Description of the project | |
| name | Yes | Name of the project | |
| owner | Yes | Repository owner (username or organization) | |
| repo | Yes | Repository name |
Implementation Reference
- operations/projects.ts:94-114 (handler)Core handler function that performs the POST request to GitHub API to create a new project in the specified repository.
export async function createProject(owner: string, repo: string, name: string, body?: string) { try { const url = `https://api.github.com/repos/${owner}/${repo}/projects`; const response = await githubRequest(url, { method: 'POST', body: { name, body: body || '', } }); return response; } catch (error) { if (error instanceof GitHubError) { throw error; } throw new GitHubError(`Failed to create project: ${(error as Error).message}`, 500, { error: (error as Error).message }); } } - operations/projects.ts:6-11 (schema)Zod schema defining the input parameters for the create_project tool: owner, repo, name, and optional body.
export const CreateProjectSchema = z.object({ owner: z.string().describe("Repository owner (username or organization)"), repo: z.string().describe("Repository name"), name: z.string().describe("Name of the project"), body: z.string().optional().describe("Description of the project"), }); - index.ts:200-204 (registration)Tool registration in the ListTools response, defining name, description, and input schema.
{ name: "create_project", description: "Create a new project in a GitHub repository", inputSchema: zodToJsonSchema(projects.CreateProjectSchema), }, - index.ts:578-589 (handler)Dispatch handler in the CallToolRequest switch statement that parses arguments and calls the projects.createProject function.
case "create_project": { const args = projects.CreateProjectSchema.parse(request.params.arguments); const result = await projects.createProject( args.owner, args.repo, args.name, args.body ); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }