@juruen @sammorrowdrums @williammartin @toby

[fork]: https://github.com/github/github-mcp-server/fork

[pr]: https://github.com/github/github-mcp-server/compare

[style]: https://github.com/github/github-mcp-server/blob/main/.golangci.yaml

Hi there! We're thrilled that you'd like to contribute to this project. Your help is essential for keeping it great.

Contributions to this project are [released](https://help.github.com/articles/github-terms-of-service/#6-contributions-under-repository-license) to the public under the [project's open source license](LICENSE.txt).

Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.

These are one time installations required to be able to test your changes locally as part of the pull request (PR) submission process.

1. install Go [through download](https://go.dev/doc/install) | [through Homebrew](https://formulae.brew.sh/formula/go)

1. [install golangci-lint](https://golangci-lint.run/welcome/install/#local-installation)

1. [Fork][fork] and clone the repository

1. Make sure the tests pass on your machine: `go test -v ./...`

1. Make sure linter passes on your machine: `golangci-lint run`

1. Create a new branch: `git checkout -b my-branch-name`

1. Make your change, add tests, and make sure the tests and linter still pass

1. Push to your fork and [submit a pull request][pr]

1. Pat yourself on the back and wait for your pull request to be reviewed and merged.

Here are a few things you can do that will increase the likelihood of your pull request being accepted:

- Follow the [style guide][style].

- Write tests.

- Keep your change as focused as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as separate pull requests.

- Write a [good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html).

- [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)

- [Using Pull Requests](https://help.github.com/articles/about-pull-requests/)

- [GitHub Help](https://help.github.com)

- **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)

"mcp": {

"inputs": [],

"servers": {

"mcp-github-server": {

"command": "path-to-your/github-mcp-server",

"args": ["stdio"],

"env": {}

Thanks for helping make GitHub safe for everyone.

GitHub takes the security of our software products and services seriously, including all of the open source code repositories managed through our GitHub organizations, such as [GitHub](https://github.com/GitHub).

Even though [open source repositories are outside of the scope of our bug bounty program](https://bounty.github.com/index.html#scope) and therefore not eligible for bounty rewards, we will ensure that your finding gets passed along to the appropriate maintainers for remediation.

If you believe you have found a security vulnerability in any GitHub-owned repository, please report it to us through coordinated disclosure.

**Please do not report security vulnerabilities through public GitHub issues, discussions, or pull requests.**

Instead, please send an email to opensource-security[@]github.com.

Please include as much of the information listed below as you can to help us better understand and resolve the issue:

* The type of issue (e.g., buffer overflow, SQL injection, or cross-site scripting)

* Full paths of source file(s) related to the manifestation of the issue

* The location of the affected source code (tag/branch/commit or direct URL)

* Any special configuration required to reproduce the issue

* Step-by-step instructions to reproduce the issue

* Proof-of-concept or exploit code (if possible)

* Impact of the issue, including how an attacker might exploit the issue

This information will help us triage your report more quickly.

See [GitHub's Safe Harbor Policy](https://docs.github.com/en/site-policy/security-policies/github-bug-bounty-program-legal-safe-harbor#1-safe-harbor-terms)

This project uses GitHub issues to track bugs and feature requests. Please search the existing issues before filing new issues to avoid duplicates. For new issues, file your bug or feature request as a new issue.

For help or questions about using this project, please open an issue.

- The `github-mcp-server` is under active development and maintained by GitHub staff **AND THE COMMUNITY**. We will do our best to respond to support, feature requests, and community questions in a timely manner.

Support for this project is limited to the resources listed above.

github.com/mark3labs/mcp-go v0.14.1

github.com/yosida95/uritemplate/v3 v3.0.2 // indirect

golang.org/x/sys v0.28.0 // indirect

golang.org/x/text v0.21.0 // indirect

github.com/mark3labs/mcp-go v0.14.1 h1:NsieyFbuWQaeZSWSHPvJ5TwJdQwu+1jmivAIVljeouY=

github.com/mark3labs/mcp-go v0.14.1/go.mod h1:xBB350hekQsJAK7gJAii8bcEoWemboLm2mRm5/+KBaU=

github.com/yosida95/uritemplate/v3 v3.0.2 h1:Ed3Oyj9yrmi9087+NczuL5BwkIc4wvTb5zIM+UJPGz4=

github.com/yosida95/uritemplate/v3 v3.0.2/go.mod h1:ILOh0sOhIJR3+L/8afwt/kE++YT040gmv5BQTMR2HP4=

golang.org/x/sys v0.28.0 h1:Fksou7UEQUWlKvIdsqzJmUmCX3cZuD2+P3XyyzwMhlA=

golang.org/x/sys v0.28.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=

golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo=

golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ=

mcp.WithDescription("Add a comment to an existing issue"),

mcp.WithDescription("Search for issues and pull requests across GitHub repositories"),

mcp.WithDescription("Get list of commits of a branch in a GitHub repository"),

mcp.WithDescription("Create or update a single file in a GitHub repository"),

mcp.WithDescription("Create a new GitHub repository in your account"),

mcp.WithDescription("Get the contents of a file or directory from a GitHub repository"),

mcp.WithDescription("Fork a GitHub repository to your account or specified organization"),

mcp.WithDescription("Create a new branch in a GitHub repository"),