* @juruen @sammorrowdrums @williammartin @toby

tags: |

id-token: write

attestations: write

- name: Generate signed build provenance attestations for workflow artifacts

uses: actions/attest-build-provenance@v2

with:

subject-path: |

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

2. Once Docker is installed, you will also need to ensure Docker is running.

3. Lastly you will need to [Create a GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new).

If you don't have Docker, you can use `go build` to build the binary in the

`cmd/github-mcp-server` directory, and use the `github-mcp-server stdio` command with the `GITHUB_PERSONAL_ACCESS_TOKEN` environment variable set to your token. To specify the output location of the build, use the `-o` flag. You should configure your server to use the built executable as its `command`. For example:

{

"mcp": {

"servers": {

"github": {

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

"args": ["stdio"],

"env": {

"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"

}

}

}

}

}

- **get_issue_comments** - Get comments for a GitHub issue

- `owner`: Repository owner (string, required)

- `repo`: Repository name (string, required)

- `issue_number`: Issue number (number, required)

- `perPage`: Results per page (number, optional)

- `comments`: Line-specific comments array of objects to place comments on pull request changes (array, optional)

- For inline comments: provide `path`, `position` (or `line`), and `body`

- For multi-line comments: provide `path`, `start_line`, `line`, optional `side`/`start_side`, and `body`

- **add_pull_request_review_comment** - Add a review comment to a pull request or reply to an existing comment

- `owner`: Repository owner (string, required)

- `repo`: Repository name (string, required)

- `pull_number`: Pull request number (number, required)

- `body`: The text of the review comment (string, required)

- `commit_id`: The SHA of the commit to comment on (string, required unless using in_reply_to)

- `path`: The relative path to the file that necessitates a comment (string, required unless using in_reply_to)

- `line`: The line of the blob in the pull request diff that the comment applies to (number, optional)

- `side`: The side of the diff to comment on (LEFT or RIGHT) (string, optional)

- `start_line`: For multi-line comments, the first line of the range (number, optional)

- `start_side`: For multi-line comments, the starting side of the diff (LEFT or RIGHT) (string, optional)

- `subject_type`: The level at which the comment is targeted (line or file) (string, optional)

- `in_reply_to`: The ID of the review comment to reply to (number, optional). When specified, only body is required and other parameters are ignored.

- **update_pull_request** - Update an existing pull request in a GitHub repository

- `owner`: Repository owner (string, required)

- `repo`: Repository name (string, required)

- `pullNumber`: Pull request number to update (number, required)

- `title`: New title (string, optional)

- `body`: New description (string, optional)

- `state`: New state ('open' or 'closed') (string, optional)

- `base`: New base branch name (string, optional)

- `maintainer_can_modify`: Allow maintainer edits (boolean, optional)

- **list_branches** - List branches in a GitHub repository

- `owner`: Repository owner (string, required)

- `repo`: Repository name (string, required)

- `page`: Page number (number, optional)

- `perPage`: Results per page (number, optional)

- **list_commits** - Get a list of commits of a branch in a repository

- **get_commit** - Get details for a commit from a repository

- `owner`: Repository owner (string, required)

- `repo`: Repository name (string, required)

- `sha`: Commit SHA, branch name, or tag name (string, required)

- `page`: Page number, for files in the commit (number, optional)

- `perPage`: Results per page, for files in the commit (number, optional)

The exported Go API of this module should currently be considered unstable, and subject to breaking changes. In the future, we may offer stability; please file an issue if there is a use case where this would be valuable.

"github.com/mark3labs/mcp-go/mcp"

enabledToolsets := viper.GetStringSlice("toolsets")

enabledToolsets: enabledToolsets,

rootCmd.PersistentFlags().StringSlice("toolsets", github.DefaultTools, "An optional comma separated list of groups of tools to allow, defaults to enabling all")

rootCmd.PersistentFlags().Bool("dynamic-toolsets", false, "Enable dynamic toolsets")

_ = viper.BindPFlag("toolsets", rootCmd.PersistentFlags().Lookup("toolsets"))

_ = viper.BindPFlag("dynamic_toolsets", rootCmd.PersistentFlags().Lookup("dynamic-toolsets"))

_ = viper.BindPFlag("host", rootCmd.PersistentFlags().Lookup("gh-host"))

viper.SetEnvPrefix("github")

enabledToolsets []string

token := viper.GetString("personal_access_token")

host := viper.GetString("host")

beforeInit := func(_ context.Context, _ any, message *mcp.InitializeRequest) {

ghClient.UserAgent = fmt.Sprintf("github-mcp-server/%s (%s/%s)", version, message.Params.ClientInfo.Name, message.Params.ClientInfo.Version)

}

getClient := func(_ context.Context) (*gogithub.Client, error) {

return ghClient, nil // closing over client

}

hooks := &server.Hooks{

OnBeforeInitialize: []server.OnBeforeInitializeFunc{beforeInit},

}

// Create server

ghServer := github.NewServer(version, server.WithHooks(hooks))

enabled := cfg.enabledToolsets

dynamic := viper.GetBool("dynamic_toolsets")

if dynamic {

// filter "all" from the enabled toolsets

enabled = make([]string, 0, len(cfg.enabledToolsets))

for _, toolset := range cfg.enabledToolsets {

if toolset != "all" {

enabled = append(enabled, toolset)

}

}

}

// Create default toolsets

toolsets, err := github.InitToolsets(enabled, cfg.readOnly, getClient, t)

context := github.InitContextToolset(getClient, t)

if err != nil {

stdlog.Fatal("Failed to initialize toolsets:", err)

}

// Register resources with the server

github.RegisterResources(ghServer, getClient, t)

// Register the tools with the server

toolsets.RegisterTools(ghServer)

context.RegisterTools(ghServer)

if dynamic {

dynamic := github.InitDynamicToolset(ghServer, toolsets, t)

dynamic.RegisterTools(ghServer)

}