GitHub MCP Server

Instructions

Implementation Reference

• src/tools.ts:278-319 (handler)

  The handler function that implements the 'create-issue' tool logic. It uses the Octokit client to create a new issue in a GitHub repository and returns the issue details or an error message.

  const createIssue = async (args: CreateIssueArgs) => {
    const { owner, repo, title, body, labels = [] } = args;
    
    try {
      const response = await octokit.rest.issues.create({
        owner,
        repo,
        title,
        body,
        labels,
      });
      
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(
              {
                number: response.data.number,
                title: response.data.title,
                url: response.data.html_url,
                created_at: response.data.created_at,
                message: "Issue created successfully",
              },
              null,
              2
            ),
          },
        ],
      };
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
      return {
        content: [
          {
            type: "text",
            text: `Error creating issue: ${errorMessage}`,
          },
        ],
      };
    }
  };

• src/tools.ts:78-110 (schema)

  The schema definition for the 'create-issue' tool, including inputSchema with properties for owner, repo, title, body, and optional labels.

  "create-issue": {
    name: "create-issue",
    description: "Create a new issue in a GitHub repository",
    inputSchema: {
      type: "object",
      properties: {
        owner: {
          type: "string",
          description: "Repository owner (username or organization)",
        },
        repo: {
          type: "string",
          description: "Repository name",
        },
        title: {
          type: "string",
          description: "Issue title",
        },
        body: {
          type: "string",
          description: "Issue body",
        },
        labels: {
          type: "array",
          items: {
            type: "string"
          },
          description: "Labels to apply to the issue",
        }
      },
      required: ["owner", "repo", "title", "body"],
    },
  },

• src/tools.ts:322-327 (registration)

  Export of toolHandlers object that maps tool names to their handler functions, including 'create-issue' to createIssue.

  export const toolHandlers = {
    "search-repos": searchRepos,
    "get-repo-info": getRepoInfo,
    "list-issues": listIssues,
    "create-issue": createIssue,
  };

• src/handlers.ts:19-21 (registration)

  Registration of ListToolsRequestSchema handler, which exposes all tool schemas (including create-issue) via Object.values(tools).

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
      tools: Object.values(tools)
  }));

• src/handlers.ts:22-32 (registration)

  Registration of CallToolRequestSchema handler, which dispatches to the appropriate tool handler (including createIssue for 'create-issue') based on name.

      server.setRequestHandler(CallToolRequestSchema, async (request) => {
          type ToolHandlerKey = keyof typeof toolHandlers;
          const { name, arguments: params } = request.params ?? {};
          const handler = toolHandlers[name as ToolHandlerKey];
  
          if (!handler) throw new Error("tool not found");
  
          type HandlerParams = Parameters<typeof handler>;
          return handler(params as any);
      })
  }