Repository files navigation

GitHub MCP Server implemented in Go.

Create a GitHub Personal Access Token with the appropriate permissionsand set it as the GITHUB_PERSONAL_ACCESS_TOKEN environment variable.

• get_me - Get details of the authenticated user
  • No parameters required

• get_issue - Gets the contents of an issue within a repository

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • issue_number: Issue number (number, required)

• add_issue_comment - Add a comment to an issue

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • issue_number: Issue number (number, required)
  • body: Comment text (string, required)

• search_issues - Search for issues and pull requests

  • query: Search query (string, required)
  • sort: Sort field (string, optional)
  • order: Sort order (string, optional)
  • page: Page number (number, optional)
  • per_page: Results per page (number, optional)

• get_pull_request - Get details of a specific pull request

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • pull_number: Pull request number (number, required)

• list_pull_requests - List and filter repository pull requests

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • state: PR state (string, optional)
  • sort: Sort field (string, optional)
  • direction: Sort direction (string, optional)
  • per_page: Results per page (number, optional)
  • page: Page number (number, optional)

• merge_pull_request - Merge a pull request

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • pull_number: Pull request number (number, required)
  • commit_title: Title for the merge commit (string, optional)
  • commit_message: Message for the merge commit (string, optional)
  • merge_method: Merge method (string, optional)

• get_pull_request_files - Get the list of files changed in a pull request

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • pull_number: Pull request number (number, required)

• get_pull_request_status - Get the combined status of all status checks for a pull request

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • pull_number: Pull request number (number, required)

• update_pull_request_branch - Update a pull request branch with the latest changes from the base branch

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • pull_number: Pull request number (number, required)
  • expected_head_sha: The expected SHA of the pull request's HEAD ref (string, optional)

• get_pull_request_comments - Get the review comments on a pull request

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • pull_number: Pull request number (number, required)

• get_pull_request_reviews - Get the reviews on a pull request

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • pull_number: Pull request number (number, required)

• create_or_update_file - Create or update a single file in a repository

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • path: File path (string, required)
  • message: Commit message (string, required)
  • content: File content (string, required)
  • branch: Branch name (string, optional)
  • sha: File SHA if updating (string, optional)

• search_repositories - Search for GitHub repositories

  • query: Search query (string, required)
  • sort: Sort field (string, optional)
  • order: Sort order (string, optional)
  • page: Page number (number, optional)
  • per_page: Results per page (number, optional)

• create_repository - Create a new GitHub repository

  • name: Repository name (string, required)
  • description: Repository description (string, optional)
  • private: Whether the repository is private (boolean, optional)
  • auto_init: Auto-initialize with README (boolean, optional)
  • gitignore_template: Gitignore template name (string, optional)

• get_file_contents - Get contents of a file or directory

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • path: File path (string, required)
  • ref: Git reference (string, optional)

• fork_repository - Fork a repository

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • organization: Target organization name (string, optional)

• create_branch - Create a new branch

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • branch: New branch name (string, required)
  • sha: SHA to create branch from (string, required)

• list_commits - Gets commits of a branch in a repository

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • sha: Branch name, tag, or commit SHA (string, optional)
  • path: Only commits containing this file path (string, optional)
  • page: Page number (number, optional)
  • per_page: Results per page (number, optional)

• search_code - Search for code across GitHub repositories

  • query: Search query (string, required)
  • sort: Sort field (string, optional)
  • order: Sort order (string, optional)
  • page: Page number (number, optional)
  • per_page: Results per page (number, optional)

• search_users - Search for GitHub users

  • query: Search query (string, required)
  • sort: Sort field (string, optional)
  • order: Sort order (string, optional)
  • page: Page number (number, optional)
  • per_page: Results per page (number, optional)

• get_code_scanning_alert - Get a code scanning alert

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • alert_number: Alert number (number, required)

• list_code_scanning_alerts - List code scanning alerts for a repository

  • owner: Repository owner (string, required)
  • repo: Repository name (string, required)
  • ref: Git reference (string, optional)
  • state: Alert state (string, optional)
  • severity: Alert severity (string, optional)

• Get Repository Content
  Retrieves the content of a repository at a specific path.

  • Template:repo://{owner}/{repo}/contents{/path*}
  • Parameters:
    • owner: Repository owner (string, required)
    • repo: Repository name (string, required)
    • path: File or directory path (string, optional)

• Get Repository Content for a Specific Branch
  Retrieves the content of a repository at a specific path for a given branch.

  • Template:repo://{owner}/{repo}/refs/heads/{branch}/contents{/path*}
  • Parameters:
    • owner: Repository owner (string, required)
    • repo: Repository name (string, required)
    • branch: Branch name (string, required)
    • path: File or directory path (string, optional)

• Get Repository Content for a Specific Commit
  Retrieves the content of a repository at a specific path for a given commit.

  • Template:repo://{owner}/{repo}/sha/{sha}/contents{/path*}
  • Parameters:
    • owner: Repository owner (string, required)
    • repo: Repository name (string, required)
    • sha: Commit SHA (string, required)
    • path: File or directory path (string, optional)

• Get Repository Content for a Specific Tag
  Retrieves the content of a repository at a specific path for a given tag.

  • Template:repo://{owner}/{repo}/refs/tags/{tag}/contents{/path*}
  • Parameters:
    • owner: Repository owner (string, required)
    • repo: Repository name (string, required)
    • tag: Tag name (string, required)
    • path: File or directory path (string, optional)

• Get Repository Content for a Specific Pull Request
  Retrieves the content of a repository at a specific path for a given pull request.

  • Template:repo://{owner}/{repo}/refs/pull/{pr_number}/head/contents{/path*}
  • Parameters:
    • owner: Repository owner (string, required)
    • repo: Repository name (string, required)
    • pr_number: Pull request number (string, required)
    • path: File or directory path (string, optional)

go run cmd/github-mcp-server/main.go stdio

E.g:

Set the PAT token in the environment variable and run:

script/get-me

And you should see the output of the GitHub MCP server responding with the user information.

GitHub MCP Server running on stdio{"jsonrpc":"2.0","id": 3,"result": {"content": [      {"type":"text","text":"{\"login\":\"juruen\",\"id\" ... }      }    ]  }}

First of all, installgithub-mcp-server with:

go install ./cmd/github-mcp-server

Make sure you:

1. Set yourGITHUB_PERSONAL_ACCESS_TOKEN environment variable and ensure VS Code has access to it.
2. VS Code Insiders has access to thegithub-mcp-server binary

Go to settings, find the MCP related settings, and set them to:

{"mcp": {"inputs": [],"servers": {"mcp-github-server": {"command":"path-to-your/github-mcp-server","args": ["stdio"],"env": {}      }    }  }}

InCopilot Edits, you should now see an option to reload the availabletools.Reload, and you should be good to go.

Try something like the following prompt to verify that it works:

I'd like to know more about my GitHub profile.

Lots of things!

Missing tools:

• push_files (files array)
• create_issue (assignees and labels arrays)
• list_issues (labels array)
• update_issue (labels and assignees arrays)
• create_pull_request_review (comments array)

Testing

• Unit tests
• Integration tests
• Blackbox testing: ideally comparing output to Anthromorphic's server to make sure that this is a fully compatible drop-in replacement.

And some other stuff:

• ...