Showing preview only (2,510K chars total). Download the full file or copy to clipboard to get everything.
Repository: github/github-mcp-server
Branch: main
Commit: b1575edfefde
Files: 357
Total size: 2.3 MB
Directory structure:
gitextract_y8of8_b_/
├── .dockerignore
├── .github/
│ ├── CODEOWNERS
│ ├── ISSUE_TEMPLATE/
│ │ ├── bug_report.md
│ │ └── feature_request.md
│ ├── agents/
│ │ └── go-sdk-tool-migrator.md
│ ├── copilot-instructions.md
│ ├── dependabot.yml
│ ├── licenses.tmpl
│ ├── prompts/
│ │ ├── bug-report-review.prompt.yml
│ │ └── default-issue-review.prompt.yml
│ ├── pull_request_template.md
│ └── workflows/
│ ├── ai-issue-assessment.yml
│ ├── close-inactive-issues.yml
│ ├── code-scanning.yml
│ ├── docker-publish.yml
│ ├── docs-check.yml
│ ├── go.yml
│ ├── goreleaser.yml
│ ├── issue-labeler.yml
│ ├── license-check.yml
│ ├── lint.yml
│ ├── mcp-diff.yml
│ ├── moderator.yml
│ └── registry-releaser.yml
├── .gitignore
├── .golangci.yml
├── .goreleaser.yaml
├── .vscode/
│ └── launch.json
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── Dockerfile
├── LICENSE
├── README.md
├── SECURITY.md
├── SUPPORT.md
├── docs/
│ ├── error-handling.md
│ ├── host-integration.md
│ ├── insiders-features.md
│ ├── installation-guides/
│ │ ├── README.md
│ │ ├── install-antigravity.md
│ │ ├── install-claude.md
│ │ ├── install-cline.md
│ │ ├── install-codex.md
│ │ ├── install-copilot-cli.md
│ │ ├── install-cursor.md
│ │ ├── install-gemini-cli.md
│ │ ├── install-other-copilot-ides.md
│ │ ├── install-roo-code.md
│ │ ├── install-rovo-dev-cli.md
│ │ └── install-windsurf.md
│ ├── policies-and-governance.md
│ ├── remote-server.md
│ ├── scope-filtering.md
│ ├── server-configuration.md
│ ├── streamable-http.md
│ ├── testing.md
│ ├── tool-renaming.md
│ └── toolsets-and-icons.md
├── e2e/
│ ├── README.md
│ └── e2e_test.go
├── gemini-extension.json
├── go.mod
├── go.sum
├── internal/
│ ├── ghmcp/
│ │ ├── server.go
│ │ └── server_test.go
│ ├── githubv4mock/
│ │ ├── githubv4mock.go
│ │ ├── local_round_tripper.go
│ │ ├── objects_are_equal_values.go
│ │ ├── objects_are_equal_values_test.go
│ │ └── query.go
│ ├── profiler/
│ │ └── profiler.go
│ └── toolsnaps/
│ ├── toolsnaps.go
│ └── toolsnaps_test.go
├── pkg/
│ ├── buffer/
│ │ ├── buffer.go
│ │ └── buffer_test.go
│ ├── context/
│ │ ├── graphql_features.go
│ │ ├── mcp_info.go
│ │ ├── request.go
│ │ └── token.go
│ ├── errors/
│ │ ├── error.go
│ │ └── error_test.go
│ ├── github/
│ │ ├── __toolsnaps__/
│ │ │ ├── actions_get.snap
│ │ │ ├── actions_list.snap
│ │ │ ├── actions_run_trigger.snap
│ │ │ ├── add_comment_to_pending_review.snap
│ │ │ ├── add_issue_comment.snap
│ │ │ ├── add_reply_to_pull_request_comment.snap
│ │ │ ├── assign_copilot_to_issue.snap
│ │ │ ├── create_branch.snap
│ │ │ ├── create_gist.snap
│ │ │ ├── create_issue.snap
│ │ │ ├── create_or_update_file.snap
│ │ │ ├── create_pull_request.snap
│ │ │ ├── create_repository.snap
│ │ │ ├── delete_file.snap
│ │ │ ├── dismiss_notification.snap
│ │ │ ├── fork_repository.snap
│ │ │ ├── get_code_scanning_alert.snap
│ │ │ ├── get_commit.snap
│ │ │ ├── get_dependabot_alert.snap
│ │ │ ├── get_discussion.snap
│ │ │ ├── get_discussion_comments.snap
│ │ │ ├── get_file_contents.snap
│ │ │ ├── get_gist.snap
│ │ │ ├── get_global_security_advisory.snap
│ │ │ ├── get_job_logs.snap
│ │ │ ├── get_label.snap
│ │ │ ├── get_latest_release.snap
│ │ │ ├── get_me.snap
│ │ │ ├── get_notification_details.snap
│ │ │ ├── get_release_by_tag.snap
│ │ │ ├── get_repository_tree.snap
│ │ │ ├── get_secret_scanning_alert.snap
│ │ │ ├── get_tag.snap
│ │ │ ├── get_team_members.snap
│ │ │ ├── get_teams.snap
│ │ │ ├── issue_read.snap
│ │ │ ├── issue_write.snap
│ │ │ ├── label_write.snap
│ │ │ ├── list_branches.snap
│ │ │ ├── list_code_scanning_alerts.snap
│ │ │ ├── list_commits.snap
│ │ │ ├── list_dependabot_alerts.snap
│ │ │ ├── list_discussion_categories.snap
│ │ │ ├── list_discussions.snap
│ │ │ ├── list_gists.snap
│ │ │ ├── list_global_security_advisories.snap
│ │ │ ├── list_issue_types.snap
│ │ │ ├── list_issues.snap
│ │ │ ├── list_label.snap
│ │ │ ├── list_notifications.snap
│ │ │ ├── list_org_repository_security_advisories.snap
│ │ │ ├── list_pull_requests.snap
│ │ │ ├── list_releases.snap
│ │ │ ├── list_repository_security_advisories.snap
│ │ │ ├── list_secret_scanning_alerts.snap
│ │ │ ├── list_starred_repositories.snap
│ │ │ ├── list_tags.snap
│ │ │ ├── manage_notification_subscription.snap
│ │ │ ├── manage_repository_notification_subscription.snap
│ │ │ ├── mark_all_notifications_read.snap
│ │ │ ├── merge_pull_request.snap
│ │ │ ├── projects_get.snap
│ │ │ ├── projects_list.snap
│ │ │ ├── projects_write.snap
│ │ │ ├── pull_request_read.snap
│ │ │ ├── pull_request_review_write.snap
│ │ │ ├── push_files.snap
│ │ │ ├── request_copilot_review.snap
│ │ │ ├── search_code.snap
│ │ │ ├── search_issues.snap
│ │ │ ├── search_orgs.snap
│ │ │ ├── search_pull_requests.snap
│ │ │ ├── search_repositories.snap
│ │ │ ├── search_users.snap
│ │ │ ├── star_repository.snap
│ │ │ ├── sub_issue_write.snap
│ │ │ ├── unstar_repository.snap
│ │ │ ├── update_gist.snap
│ │ │ ├── update_pull_request.snap
│ │ │ └── update_pull_request_branch.snap
│ │ ├── actions.go
│ │ ├── actions_test.go
│ │ ├── code_scanning.go
│ │ ├── code_scanning_test.go
│ │ ├── context_tools.go
│ │ ├── context_tools_test.go
│ │ ├── copilot.go
│ │ ├── copilot_test.go
│ │ ├── dependabot.go
│ │ ├── dependabot_test.go
│ │ ├── dependencies.go
│ │ ├── dependencies_test.go
│ │ ├── deprecated_tool_aliases.go
│ │ ├── discussions.go
│ │ ├── discussions_test.go
│ │ ├── dynamic_tools.go
│ │ ├── dynamic_tools_test.go
│ │ ├── feature_flags.go
│ │ ├── feature_flags_test.go
│ │ ├── gists.go
│ │ ├── gists_test.go
│ │ ├── git.go
│ │ ├── git_test.go
│ │ ├── helper_test.go
│ │ ├── inventory.go
│ │ ├── issues.go
│ │ ├── issues_test.go
│ │ ├── labels.go
│ │ ├── labels_test.go
│ │ ├── minimal_types.go
│ │ ├── notifications.go
│ │ ├── notifications_test.go
│ │ ├── params.go
│ │ ├── params_test.go
│ │ ├── projects.go
│ │ ├── projects_test.go
│ │ ├── prompts.go
│ │ ├── pullrequests.go
│ │ ├── pullrequests_test.go
│ │ ├── repositories.go
│ │ ├── repositories_helper.go
│ │ ├── repositories_test.go
│ │ ├── repository_resource.go
│ │ ├── repository_resource_completions.go
│ │ ├── repository_resource_completions_test.go
│ │ ├── repository_resource_test.go
│ │ ├── resources.go
│ │ ├── scope_filter.go
│ │ ├── scope_filter_test.go
│ │ ├── search.go
│ │ ├── search_test.go
│ │ ├── search_utils.go
│ │ ├── search_utils_test.go
│ │ ├── secret_scanning.go
│ │ ├── secret_scanning_test.go
│ │ ├── security_advisories.go
│ │ ├── security_advisories_test.go
│ │ ├── server.go
│ │ ├── server_test.go
│ │ ├── tools.go
│ │ ├── tools_test.go
│ │ ├── tools_validation_test.go
│ │ ├── toolset_icons_test.go
│ │ ├── toolset_instructions.go
│ │ ├── ui_capability.go
│ │ ├── ui_capability_test.go
│ │ ├── ui_dist/
│ │ │ ├── .gitkeep
│ │ │ └── .placeholder.html
│ │ ├── ui_embed.go
│ │ ├── ui_resources.go
│ │ └── workflow_prompts.go
│ ├── http/
│ │ ├── handler.go
│ │ ├── handler_test.go
│ │ ├── headers/
│ │ │ ├── headers.go
│ │ │ ├── parse.go
│ │ │ └── parse_test.go
│ │ ├── mark/
│ │ │ └── mark.go
│ │ ├── middleware/
│ │ │ ├── mcp_parse.go
│ │ │ ├── mcp_parse_test.go
│ │ │ ├── pat_scope.go
│ │ │ ├── pat_scope_test.go
│ │ │ ├── request_config.go
│ │ │ ├── scope_challenge.go
│ │ │ ├── token.go
│ │ │ └── token_test.go
│ │ ├── oauth/
│ │ │ ├── oauth.go
│ │ │ └── oauth_test.go
│ │ ├── server.go
│ │ └── transport/
│ │ ├── bearer.go
│ │ ├── graphql_features.go
│ │ ├── graphql_features_test.go
│ │ └── user_agent.go
│ ├── inventory/
│ │ ├── builder.go
│ │ ├── errors.go
│ │ ├── filters.go
│ │ ├── instructions.go
│ │ ├── instructions_test.go
│ │ ├── prompts.go
│ │ ├── registry.go
│ │ ├── registry_test.go
│ │ ├── resources.go
│ │ └── server_tool.go
│ ├── lockdown/
│ │ ├── lockdown.go
│ │ └── lockdown_test.go
│ ├── log/
│ │ ├── io.go
│ │ └── io_test.go
│ ├── octicons/
│ │ ├── octicons.go
│ │ ├── octicons_test.go
│ │ └── required_icons.txt
│ ├── raw/
│ │ ├── raw.go
│ │ └── raw_test.go
│ ├── sanitize/
│ │ ├── sanitize.go
│ │ └── sanitize_test.go
│ ├── scopes/
│ │ ├── fetcher.go
│ │ ├── fetcher_test.go
│ │ ├── map.go
│ │ ├── map_test.go
│ │ ├── scopes.go
│ │ └── scopes_test.go
│ ├── tooldiscovery/
│ │ ├── search.go
│ │ └── search_test.go
│ ├── translations/
│ │ └── translations.go
│ └── utils/
│ ├── api.go
│ ├── api_test.go
│ ├── result.go
│ └── token.go
├── script/
│ ├── build-ui
│ ├── conformance-test
│ ├── fetch-icons
│ ├── generate-docs
│ ├── get-discussions
│ ├── get-me
│ ├── licenses
│ ├── licenses-check
│ ├── lint
│ ├── list-scopes
│ ├── prettyprint-log
│ ├── tag-release
│ └── test
├── server.json
├── third-party/
│ ├── github.com/
│ │ ├── aymerick/
│ │ │ └── douceur/
│ │ │ └── LICENSE
│ │ ├── fsnotify/
│ │ │ └── fsnotify/
│ │ │ └── LICENSE
│ │ ├── go-chi/
│ │ │ └── chi/
│ │ │ └── v5/
│ │ │ └── LICENSE
│ │ ├── go-openapi/
│ │ │ ├── jsonpointer/
│ │ │ │ └── LICENSE
│ │ │ └── swag/
│ │ │ └── LICENSE
│ │ ├── go-viper/
│ │ │ └── mapstructure/
│ │ │ └── v2/
│ │ │ └── LICENSE
│ │ ├── google/
│ │ │ ├── go-github/
│ │ │ │ └── v82/
│ │ │ │ └── github/
│ │ │ │ └── LICENSE
│ │ │ ├── go-querystring/
│ │ │ │ └── query/
│ │ │ │ └── LICENSE
│ │ │ └── jsonschema-go/
│ │ │ └── jsonschema/
│ │ │ └── LICENSE
│ │ ├── gorilla/
│ │ │ └── css/
│ │ │ └── scanner/
│ │ │ └── LICENSE
│ │ ├── inconshreveable/
│ │ │ └── mousetrap/
│ │ │ └── LICENSE
│ │ ├── josephburnett/
│ │ │ └── jd/
│ │ │ └── v2/
│ │ │ └── LICENSE
│ │ ├── josharian/
│ │ │ └── intern/
│ │ │ └── license.md
│ │ ├── lithammer/
│ │ │ └── fuzzysearch/
│ │ │ └── fuzzy/
│ │ │ └── LICENSE
│ │ ├── mailru/
│ │ │ └── easyjson/
│ │ │ └── LICENSE
│ │ ├── microcosm-cc/
│ │ │ └── bluemonday/
│ │ │ └── LICENSE.md
│ │ ├── modelcontextprotocol/
│ │ │ └── go-sdk/
│ │ │ └── LICENSE
│ │ ├── muesli/
│ │ │ └── cache2go/
│ │ │ └── LICENSE.txt
│ │ ├── pelletier/
│ │ │ └── go-toml/
│ │ │ └── v2/
│ │ │ └── LICENSE
│ │ ├── sagikazarmark/
│ │ │ └── locafero/
│ │ │ └── LICENSE
│ │ ├── segmentio/
│ │ │ ├── asm/
│ │ │ │ └── LICENSE
│ │ │ └── encoding/
│ │ │ └── LICENSE
│ │ ├── shurcooL/
│ │ │ ├── githubv4/
│ │ │ │ └── LICENSE
│ │ │ └── graphql/
│ │ │ └── LICENSE
│ │ ├── sourcegraph/
│ │ │ └── conc/
│ │ │ └── LICENSE
│ │ ├── spf13/
│ │ │ ├── afero/
│ │ │ │ └── LICENSE.txt
│ │ │ ├── cast/
│ │ │ │ └── LICENSE
│ │ │ ├── cobra/
│ │ │ │ └── LICENSE.txt
│ │ │ ├── pflag/
│ │ │ │ └── LICENSE
│ │ │ └── viper/
│ │ │ └── LICENSE
│ │ ├── subosito/
│ │ │ └── gotenv/
│ │ │ └── LICENSE
│ │ └── yosida95/
│ │ └── uritemplate/
│ │ └── v3/
│ │ └── LICENSE
│ ├── go.yaml.in/
│ │ └── yaml/
│ │ └── v3/
│ │ ├── LICENSE
│ │ └── NOTICE
│ ├── golang.org/
│ │ └── x/
│ │ ├── exp/
│ │ │ └── slices/
│ │ │ └── LICENSE
│ │ ├── net/
│ │ │ └── html/
│ │ │ └── LICENSE
│ │ ├── sys/
│ │ │ └── LICENSE
│ │ └── text/
│ │ └── LICENSE
│ └── gopkg.in/
│ └── yaml.v3/
│ ├── LICENSE
│ └── NOTICE
├── third-party-licenses.darwin.md
├── third-party-licenses.linux.md
├── third-party-licenses.windows.md
└── ui/
├── package.json
├── src/
│ ├── apps/
│ │ ├── get-me/
│ │ │ ├── App.tsx
│ │ │ └── index.html
│ │ ├── issue-write/
│ │ │ ├── App.tsx
│ │ │ └── index.html
│ │ └── pr-write/
│ │ ├── App.tsx
│ │ └── index.html
│ ├── components/
│ │ ├── AppProvider.tsx
│ │ └── MarkdownEditor.tsx
│ ├── hooks/
│ │ └── useMcpApp.ts
│ └── vite-env.d.ts
├── tsconfig.json
└── vite.config.ts
================================================
FILE CONTENTS
================================================
================================================
FILE: .dockerignore
================================================
.github
.vscode
script
third-party
.dockerignore
.gitignore
**/*.yml
**/*.yaml
**/*.md
**/*_test.go
LICENSE
================================================
FILE: .github/CODEOWNERS
================================================
* @github/github-mcp-server
================================================
FILE: .github/ISSUE_TEMPLATE/bug_report.md
================================================
---
name: "\U0001F41B Bug report"
about: Report a bug or unexpected behavior while using GitHub MCP Server
title: ''
labels: bug
assignees: ''
---
### Describe the bug
A clear and concise description of what the bug is.
### Affected version
Please run ` docker run -i --rm ghcr.io/github/github-mcp-server ./github-mcp-server --version` and paste the output below
### Steps to reproduce the behavior
1. Type this '...'
2. View the output '....'
3. See error
### Expected vs actual behavior
A clear and concise description of what you expected to happen and what actually happened.
### Logs
Paste any available logs. Redact if needed.
================================================
FILE: .github/ISSUE_TEMPLATE/feature_request.md
================================================
---
name: "⭐ Submit a feature request"
about: Surface a feature or problem that you think should be solved
title: ''
labels: enhancement
assignees: ''
---
### Describe the feature or problem you’d like to solve
A clear and concise description of what the feature or problem is.
### Proposed solution
How will it benefit GitHub MCP Server and its users?
### Example prompts or workflows (for tools/toolsets only)
If it's a new tool or improvement, share 3–5 example prompts or workflows it would enable. Just enough detail to show the value. Clear, valuable use cases are more likely to get approved.
### Additional context
Add any other context like screenshots or mockups are helpful, if applicable.
================================================
FILE: .github/agents/go-sdk-tool-migrator.md
================================================
---
name: go-sdk-tool-migrator
description: Agent specializing in migrating MCP tools from mark3labs/mcp-go to modelcontextprotocol/go-sdk
---
# Go SDK Tool Migrator Agent
You are a specialized agent designed to assist developers in migrating MCP tools from the mark3labs/mcp-go library to the modelcontextprotocol/go-sdk. Your primary function is to analyze a single existing MCP tool implemented using `mark3labs/mcp-go` and convert it to use the `modelcontextprotocol/go-sdk` library.
## Migration Process
You should focus on ONLY the toolset you are asked to migrate and its corresponding test file. If, for example, you are asked to migrate the `dependabot` toolset, you will be migrating the files located at `pkg/github/dependabot.go` and `pkg/github/dependabot_test.go`. If there are additional tests or helper functions that fail to work with the new SDK, you should inform me of these issues so that I can address them, or instruct you on how to proceed.
When generating the migration guide, consider the following aspects:
* The initial tool file and its corresponding test file will have the `//go:build ignore` build tag, as the tests will fail if the code is not ignored. The `ignore` build tag should be removed before work begins.
* The import for `github.com/mark3labs/mcp-go/mcp` should be changed to `github.com/modelcontextprotocol/go-sdk/mcp`
* The return type for the tool constructor function should be updated from `mcp.Tool, server.ToolHandlerFunc` to `(mcp.Tool, mcp.ToolHandlerFor[map[string]any, any])`.
* The tool handler function signature should be updated to use generics, changing from `func(ctx context.Context, mcp.CallToolRequest) (*mcp.CallToolResult, error)` to `func(context.Context, *mcp.CallToolRequest, map[string]any) (*mcp.CallToolResult, any, error)`.
* The `RequiredParam`, `RequiredInt`, `RequiredBigInt`, `OptionalParamOK`, `OptionalParam`, `OptionalIntParam`, `OptionalIntParamWithDefault`, `OptionalBoolParamWithDefault`, `OptionalStringArrayParam`, `OptionalBigIntArrayParam` and `OptionalCursorPaginationParams` functions should be changed to use the tool arguments that are now passed as a map in the tool handler function, rather than extracting them from the `mcp.CallToolRequest`.
* `mcp.NewToolResultText`, `mcp.NewToolResultError`, `mcp.NewToolResultErrorFromErr` and `mcp.NewToolResultResource` no longer available in `modelcontextprotocol/go-sdk`. There are a few helper functions available in `pkg/utils/result.go` that can be used to replace these, in the `utils` package.
### Schema Changes
The biggest change when migrating MCP tools from mark3labs/mcp-go to modelcontextprotocol/go-sdk is the way input and output schemas are defined and handled. In `mark3labs/mcp-go`, input and output schemas were often defined using a DSL provided by the library. In `modelcontextprotocol/go-sdk`, schemas are defined using `jsonschema.Schema` structures using `github.com/google/jsonschema-go`, which are more verbose.
When migrating a tool, you will need to convert the existing schema definitions to JSON Schema format. This involves defining the properties, types, and any validation rules using the JSON Schema specification.
#### Example Schema Guide
If we take an example of a tool that has the following input schema in mark3labs/mcp-go:
```go
...
return mcp.NewTool(
"list_dependabot_alerts",
mcp.WithDescription(t("TOOL_LIST_DEPENDABOT_ALERTS_DESCRIPTION", "List dependabot alerts in a GitHub repository.")),
mcp.WithToolAnnotation(mcp.ToolAnnotation{
Title: t("TOOL_LIST_DEPENDABOT_ALERTS_USER_TITLE", "List dependabot alerts"),
ReadOnlyHint: ToBoolPtr(true),
}),
mcp.WithString("owner",
mcp.Required(),
mcp.Description("The owner of the repository."),
),
mcp.WithString("repo",
mcp.Required(),
mcp.Description("The name of the repository."),
),
mcp.WithString("state",
mcp.Description("Filter dependabot alerts by state. Defaults to open"),
mcp.DefaultString("open"),
mcp.Enum("open", "fixed", "dismissed", "auto_dismissed"),
),
mcp.WithString("severity",
mcp.Description("Filter dependabot alerts by severity"),
mcp.Enum("low", "medium", "high", "critical"),
),
),
...
```
The corresponding input schema in modelcontextprotocol/go-sdk would look like this:
```go
...
return mcp.Tool{
Name: "list_dependabot_alerts",
Description: t("TOOL_LIST_DEPENDABOT_ALERTS_DESCRIPTION", "List dependabot alerts in a GitHub repository."),
Annotations: &mcp.ToolAnnotations{
Title: t("TOOL_LIST_DEPENDABOT_ALERTS_USER_TITLE", "List dependabot alerts"),
ReadOnlyHint: true,
},
InputSchema: &jsonschema.Schema{
Type: "object",
Properties: map[string]*jsonschema.Schema{
"owner": {
Type: "string",
Description: "The owner of the repository.",
},
"repo": {
Type: "string",
Description: "The name of the repository.",
},
"state": {
Type: "string",
Description: "Filter dependabot alerts by state. Defaults to open",
Enum: []any{"open", "fixed", "dismissed", "auto_dismissed"},
Default: "open",
},
"severity": {
Type: "string",
Description: "Filter dependabot alerts by severity",
Enum: []any{"low", "medium", "high", "critical"},
},
},
Required: []string{"owner", "repo"},
},
}
```
### Tests
After migrating the tool code and test file, ensure that all tests pass successfully. If any tests fail, review the error messages and adjust the migrated code as necessary to resolve any issues. If you encounter any challenges or need further assistance during the migration process, please let me know.
At the end of your changes, you will continue to have an issue with the `toolsnaps` tests, these validate that the schema has not changed unexpectedly. You can update the snapshots by setting `UPDATE_TOOLSNAPS=true` before running the tests, e.g.:
```bash
UPDATE_TOOLSNAPS=true go test ./...
```
You should however, only update the toolsnaps after confirming that the schema changes are intentional and correct. Some schema changes are unavoidable, such as argument ordering, however the schemas themselves should remain logically equivalent.
================================================
FILE: .github/copilot-instructions.md
================================================
# GitHub MCP Server - Copilot Instructions
## Project Overview
This is the **GitHub MCP Server**, a Model Context Protocol (MCP) server that connects AI tools to GitHub's platform. It enables AI agents to manage repositories, issues, pull requests, workflows, and more through natural language.
**Key Details:**
- **Language:** Go 1.24+ (~38k lines of code)
- **Type:** MCP server application with CLI interface
- **Primary Package:** github-mcp-server (stdio MCP server - **this is the main focus**)
- **Secondary Package:** mcpcurl (testing utility - don't break it, but not the priority)
- **Framework:** Uses modelcontextprotocol/go-sdk for MCP protocol, google/go-github for GitHub API
- **Size:** ~60MB repository, 70 Go files
- **Library Usage:** This repository is also used as a library by the remote server. Functions that could be called by other repositories should be exported (capitalized), even if not required internally. Preserve existing export patterns.
**Code Quality Standards:**
- **Popular Open Source Repository** - High bar for code quality and clarity
- **Comprehension First** - Code must be clear to a wide audience
- **Clean Commits** - Atomic, focused changes with clear messages
- **Structure** - Always maintain or improve, never degrade
- **Code over Comments** - Prefer self-documenting code; comment only when necessary
## Critical Build & Validation Steps
### Required Commands (Run Before Committing)
**ALWAYS run these commands in this exact order before using report_progress or finishing work:**
1. **Format Code:** `script/lint` (runs `gofmt -s -w .` then `golangci-lint`)
2. **Run Tests:** `script/test` (runs `go test -race ./...`)
3. **Update Documentation:** `script/generate-docs` (if you modified MCP tools/toolsets)
**These commands are FAST:** Lint ~1s, Tests ~1s (cached), Build ~1s
### When Modifying MCP Tools/Endpoints
If you change any MCP tool definitions or schemas:
1. Run tests with `UPDATE_TOOLSNAPS=true go test ./...` to update toolsnaps
2. Commit the updated `.snap` files in `pkg/github/__toolsnaps__/`
3. Run `script/generate-docs` to update README.md
4. Toolsnaps document API surface and ensure changes are intentional
### Common Build Commands
```bash
# Download dependencies (rarely needed - usually cached)
go mod download
# Build the server binary
go build -v ./cmd/github-mcp-server
# Run the server
./github-mcp-server stdio
# Run specific package tests
go test ./pkg/github -v
# Run specific test
go test ./pkg/github -run TestGetMe
```
## Project Structure
### Directory Layout
```
.
├── cmd/
│ ├── github-mcp-server/ # Main MCP server entry point (PRIMARY FOCUS)
│ └── mcpcurl/ # MCP testing utility (secondary - don't break it)
├── pkg/ # Public API packages
│ ├── github/ # GitHub API MCP tools implementation
│ │ └── __toolsnaps__/ # Tool schema snapshots (*.snap files)
│ ├── toolsets/ # Toolset configuration & management
│ ├── errors/ # Error handling utilities
│ ├── sanitize/ # HTML/content sanitization
│ ├── log/ # Logging utilities
│ ├── raw/ # Raw data handling
│ ├── buffer/ # Buffer utilities
│ └── translations/ # i18n translation support
├── internal/ # Internal implementation packages
│ ├── ghmcp/ # GitHub MCP server core logic
│ ├── githubv4mock/ # GraphQL API mocking for tests
│ ├── toolsnaps/ # Toolsnap validation system
│ └── profiler/ # Performance profiling
├── e2e/ # End-to-end tests (require GitHub PAT)
├── script/ # Build and maintenance scripts
├── docs/ # Documentation
├── .github/workflows/ # CI/CD workflows
└── [config files] # See below
```
### Key Configuration Files
- **go.mod / go.sum:** Go module dependencies (Go 1.24.0+)
- **.golangci.yml:** Linter configuration (v2 format, ~15 linters enabled)
- **Dockerfile:** Multi-stage build (golang:1.25.3-alpine → distroless)
- **server.json:** MCP server metadata for registry
- **.goreleaser.yaml:** Release automation config
- **.gitignore:** Excludes bin/, dist/, vendor/, *.DS_Store, github-mcp-server binary
### Important Scripts (script/ directory)
- **script/lint** - Runs `gofmt` + `golangci-lint`. **MUST RUN** before committing
- **script/test** - Runs `go test -race ./...` (full test suite)
- **script/generate-docs** - Updates README.md tool documentation. Run after tool changes
- **script/licenses** - Updates third-party license files when dependencies change
- **script/licenses-check** - Validates license compliance (runs in CI)
- **script/get-me** - Quick test script for get_me tool
- **script/get-discussions** - Quick test for discussions
- **script/tag-release** - **NEVER USE THIS** - releases are managed separately
## GitHub Workflows (CI/CD)
All workflows run on push/PR unless noted. Located in `.github/workflows/`:
1. **go.yml** - Build and test on ubuntu/windows/macos. Runs `script/test` and builds binary
2. **lint.yml** - Runs golangci-lint-action v2.5 (GitHub Action) with actions/setup-go stable
3. **docs-check.yml** - Verifies README.md is up-to-date by running generate-docs and checking git diff
4. **code-scanning.yml** - CodeQL security analysis for Go and GitHub Actions
5. **license-check.yml** - Runs `script/licenses-check` to validate compliance
6. **docker-publish.yml** - Publishes container image to ghcr.io
7. **goreleaser.yml** - Creates releases (main branch only)
8. **registry-releaser.yml** - Updates MCP registry
**All of these must pass for PR merge.** If docs-check fails, run `script/generate-docs` and commit changes.
## Testing Guidelines
### Unit Tests
- Use `testify` for assertions (`require` for critical checks, `assert` for non-blocking)
- Tests are in `*_test.go` files alongside implementation (internal tests, not `_test` package)
- Mock GitHub API with `go-github-mock` (REST) or `githubv4mock` (GraphQL)
- Test structure for tools:
1. Test tool snapshot
2. Verify critical schema properties (e.g., ReadOnly annotation)
3. Table-driven behavioral tests
### Toolsnaps (Tool Schema Snapshots)
- Every MCP tool has a JSON schema snapshot in `pkg/github/__toolsnaps__/*.snap`
- Tests fail if current schema differs from snapshot (shows diff)
- To update after intentional changes: `UPDATE_TOOLSNAPS=true go test ./...`
- **MUST commit updated .snap files** - they document API changes
- Missing snapshots cause CI failure
### End-to-End Tests
- Located in `e2e/` directory with `e2e_test.go`
- **Require GitHub PAT token** - you usually cannot run these yourself
- Run with: `GITHUB_MCP_SERVER_E2E_TOKEN=<token> go test -v --tags e2e ./e2e`
- Tests interact with live GitHub API via Docker container
- **Keep e2e tests updated when changing MCP tools**
- **Use only the e2e test style** when modifying tests in this directory
- For debugging: `GITHUB_MCP_SERVER_E2E_DEBUG=true` runs in-process (no Docker)
## Code Style & Linting
### Go Code Requirements
- **gofmt with simplify flag (-s)** - Automatically run by `script/lint`
- **golangci-lint** with these linters enabled:
- bodyclose, gocritic, gosec, makezero, misspell, nakedret, revive
- errcheck, staticcheck, govet, ineffassign, unused
- Exclusions for: third_party/, builtin/, examples/, generated code
### Go Naming Conventions
- **Acronyms in identifiers:** Use `ID` not `Id`, `API` not `Api`, `URL` not `Url`, `HTTP` not `Http`
- Examples: `userID`, `getAPI`, `parseURL`, `HTTPClient`
- This applies to variable names, function names, struct fields, etc.
### Code Patterns
- **Keep changes minimal and focused** on the specific issue being addressed
- **Prefer clarity over cleverness** - code must be understandable by a wide audience
- **Atomic commits** - each commit should be a complete, logical change
- **Maintain or improve structure** - never degrade code organization
- Use table-driven tests for behavioral testing
- Comment sparingly - code should be self-documenting
- Follow standard Go conventions (Effective Go, Go proverbs)
- **Test changes thoroughly** before committing
- Export functions (capitalize) if they could be used by other repos as a library
## Common Development Workflows
### Adding a New MCP Tool
1. Add tool implementation in `pkg/github/` (e.g., `foo_tools.go`)
2. Register tool in appropriate toolset in `pkg/github/` or `pkg/toolsets/`
3. Write unit tests following the tool test pattern
4. Run `UPDATE_TOOLSNAPS=true go test ./...` to create snapshot
5. Run `script/generate-docs` to update README
6. Run `script/lint` and `script/test` before committing
7. If e2e tests are relevant, update `e2e/e2e_test.go` using existing test style
8. Commit code + snapshots + README changes together
### Fixing a Bug
1. Write a failing test that reproduces the bug
2. Fix the bug with minimal changes
3. Verify test passes and existing tests still pass
4. Run `script/lint` and `script/test`
5. If tool schema changed, update toolsnaps (see above)
### Updating Dependencies
1. Update `go.mod` (e.g., `go get -u ./...` or manually)
2. Run `go mod tidy`
3. Run `script/licenses` to update license files
4. Run `script/test` to verify nothing broke
5. Commit go.mod, go.sum, and third-party-licenses* files
## Common Errors & Solutions
### "Documentation is out of date" in CI
**Fix:** Run `script/generate-docs` and commit README.md changes
### Toolsnap mismatch failures
**Fix:** Run `UPDATE_TOOLSNAPS=true go test ./...` and commit updated .snap files
### Lint failures
**Fix:** Run `script/lint` locally - it will auto-format and show issues. Fix manually reported issues.
### License check failures
**Fix:** Run `script/licenses` to regenerate license files after dependency changes
### Test failures after changing a tool
**Likely causes:**
1. Forgot to update toolsnaps - run with `UPDATE_TOOLSNAPS=true`
2. Changed behavior broke existing tests - verify intent and fix tests
3. Schema change not reflected in test - update test expectations
## Environment Variables
- **GITHUB_PERSONAL_ACCESS_TOKEN** - Required for server operation and e2e tests
- **GITHUB_HOST** - For GitHub Enterprise Server (prefix with `https://`)
- **GITHUB_TOOLSETS** - Comma-separated toolset list (overrides --toolsets flag)
- **GITHUB_READ_ONLY** - Set to "1" for read-only mode
- **GITHUB_DYNAMIC_TOOLSETS** - Set to "1" for dynamic toolset discovery
- **UPDATE_TOOLSNAPS** - Set to "true" when running tests to update snapshots
- **GITHUB_MCP_SERVER_E2E_TOKEN** - Token for e2e tests
- **GITHUB_MCP_SERVER_E2E_DEBUG** - Set to "true" for in-process e2e debugging
## Key Files Reference
### Root Directory Files
```
.dockerignore - Docker build exclusions
.gitignore - Git exclusions (includes bin/, dist/, vendor/, binaries)
.golangci.yml - Linter configuration
.goreleaser.yaml - Release automation
CODE_OF_CONDUCT.md - Community guidelines
CONTRIBUTING.md - Contribution guide (fork, clone, test, lint workflow)
Dockerfile - Multi-stage Go build
LICENSE - MIT license
README.md - Main documentation (auto-generated sections)
SECURITY.md - Security policy
SUPPORT.md - Support resources
gemini-extension.json - Gemini CLI configuration
go.mod / go.sum - Go dependencies
server.json - MCP server registry metadata
```
### Main Entry Point
`cmd/github-mcp-server/main.go` - Uses cobra for CLI, viper for config, supports:
- `stdio` command (default) - MCP stdio transport
- `generate-docs` command - Documentation generation
- Flags: --toolsets, --read-only, --dynamic-toolsets, --gh-host, --log-file
## Important Reminders
1. **PRIMARY FOCUS:** The local stdio MCP server (github-mcp-server) - this is what you should work on and test with
2. **REMOTE SERVER:** Ignore remote server instructions when making code changes (unless specifically asked). This repo is used as a library by the remote server, so keep functions exported (capitalized) if they could be called by other repos, even if not needed internally.
3. **ALWAYS** trust these instructions first - only search if information is incomplete or incorrect
4. **NEVER** use `script/tag-release` or push tags
5. **NEVER** skip `script/lint` before committing Go code changes
6. **ALWAYS** update toolsnaps when changing MCP tool schemas
7. **ALWAYS** run `script/generate-docs` after modifying tools
8. For specific test files, use `go test ./path -run TestName` not full suite
9. E2E tests require PAT token - you likely cannot run them
10. Toolsnaps are API documentation - treat changes seriously
11. Build/test/lint are very fast (~1s each) - run frequently
12. CI failures for docs-check or license-check have simple fixes (run the script)
13. mcpcurl is secondary - don't break it, but it's not the priority
================================================
FILE: .github/dependabot.yml
================================================
# To get started with Dependabot version updates, you'll need to specify which
# package ecosystems to update and where the package manifests are located.
# Please see the documentation for all configuration options:
# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
version: 2
updates:
- package-ecosystem: "gomod"
directory: "/"
schedule:
interval: "weekly"
- package-ecosystem: "docker"
directory: "/"
schedule:
interval: "weekly"
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
================================================
FILE: .github/licenses.tmpl
================================================
# GitHub MCP Server dependencies
The following open source dependencies are used to build the [github/github-mcp-server][] GitHub Model Context Protocol Server.
## Go Packages
Some packages may only be included on certain architectures or operating systems.
{{ range . }}
- [{{.Name}}](https://pkg.go.dev/{{.Name}}) ([{{.LicenseName}}]({{.LicenseURL}}))
{{- end }}
[github/github-mcp-server]: https://github.com/github/github-mcp-server
================================================
FILE: .github/prompts/bug-report-review.prompt.yml
================================================
messages:
- role: system
content: |
You are a triage assistant for the GitHub MCP Server repository. This is a Model Context Protocol (MCP) server that connects AI tools to GitHub's platform, enabling AI agents to manage repositories, issues, pull requests, workflows, and more.
Your job is to analyze bug reports and assess their completeness.
**CRITICAL: Detect unfilled templates**
- Flag issues containing unmodified template text like "A clear and concise description of what the bug is"
- Flag placeholder values like "Type this '...'" or "View the output '....'" that haven't been replaced
- Flag generic/meaningless titles (e.g., random words, test content)
- These are ALWAYS "Missing Details" even if the template structure is present
Analyze the issue for these key elements:
1. Clear description of the problem (not template text)
2. Affected version (from running `docker run -i --rm ghcr.io/github/github-mcp-server ./github-mcp-server --version`)
3. Steps to reproduce the behavior (actual steps, not placeholders)
4. Expected vs actual behavior (real descriptions, not template text)
5. Relevant logs (if applicable)
Provide ONE of these assessments:
### AI Assessment: Ready for Review
Use when the bug report has actual information in required fields and can be triaged by a maintainer.
### AI Assessment: Missing Details
Use when:
- Template text has not been replaced with actual content
- Critical information is missing (no reproduction steps, no version info, unclear problem description)
- The title is meaningless or spam-like
- Placeholder text remains in any section
When marking as Missing Details, recommend adding the "waiting-for-reply" label.
### AI Assessment: Unsure
Use when you cannot determine the completeness of the report.
After your assessment header, provide a brief explanation of your rating.
If details are missing, be specific about which sections contain template text or need actual information.
- role: user
content: "{{input}}"
model: openai/gpt-4o-mini
modelParameters:
max_tokens: 500
================================================
FILE: .github/prompts/default-issue-review.prompt.yml
================================================
messages:
- role: system
content: |
You are a triage assistant for the GitHub MCP Server repository. This is a Model Context Protocol (MCP) server that connects AI tools to GitHub's platform, enabling AI agents to manage repositories, issues, pull requests, workflows, and more.
Your job is to analyze new issues and help categorize them.
**CRITICAL: Detect invalid or incomplete submissions**
- Flag issues with unmodified template text (e.g., "A clear and concise description...")
- Flag placeholder values that haven't been replaced (e.g., "Type this '...'", "....", "XXX")
- Flag meaningless, spam-like, or test titles (e.g., random words, nonsensical content)
- Flag empty or nearly empty issues
- These are ALWAYS "Missing Details" or "Invalid" depending on severity
Analyze the issue to determine:
1. Is this a bug report, feature request, question, documentation issue, or something else?
2. Is the issue clear and well-described with actual content (not template text)?
3. Does it contain enough information for maintainers to act on?
4. Is this potentially spam, a test issue, or completely invalid?
Provide ONE of these assessments:
### AI Assessment: Ready for Review
Use when the issue is clear, well-described with actual content, and contains enough context for maintainers to understand and act on it.
### AI Assessment: Missing Details
Use when:
- Template text has not been replaced with actual content
- The issue is unclear or lacks context
- Critical information is missing to make it actionable
- The title is vague but the issue seems legitimate
When marking as Missing Details, recommend adding the "waiting-for-reply" label.
### AI Assessment: Invalid
Use when:
- The issue appears to be spam or test content
- The title is completely meaningless and body has no useful information
- This doesn't relate to the GitHub MCP Server project at all
When marking as Invalid, recommend adding the "invalid" label and consider closing.
### AI Assessment: Unsure
Use when you cannot determine the nature or completeness of the issue.
After your assessment header, provide a brief explanation including:
- What type of issue this appears to be (bug, feature request, question, invalid, etc.)
- Which specific sections contain template text or need actual information
- What additional information might be helpful if any
- role: user
content: "{{input}}"
model: openai/gpt-4o-mini
modelParameters:
max_tokens: 500
================================================
FILE: .github/pull_request_template.md
================================================
<!--
Copilot: Fill all sections. Prefer short, concrete answers.
If a checkbox is selected, add a brief explanation.
-->
## Summary
<!-- In 1–2 sentences: what does this PR do? -->
## Why
<!-- Why is this change needed? Link issues or discussions. -->
Fixes #
## What changed
<!-- Bullet list of concrete changes. -->
-
-
## MCP impact
<!-- Select one or more. If selected, add 1–2 sentences. -->
- [ ] No tool or API changes
- [ ] Tool schema or behavior changed
- [ ] New tool added
## Prompts tested (tool changes only)
<!-- If you changed or added tools, list example prompts you tested. -->
<!-- Include prompts that trigger the tool and describe the use case. -->
<!-- Example: "List all open issues in the repo assigned to me" -->
-
## Security / limits
<!-- Select if relevant. Add a short note if checked. -->
- [ ] No security or limits impact
- [ ] Auth / permissions considered
- [ ] Data exposure, filtering, or token/size limits considered
## Tool renaming
- [ ] I am renaming tools as part of this PR (e.g. a part of a consolidation effort)
- [ ] I have added the new tool aliases in `deprecated_tool_aliases.go`
- [ ] I am not renaming tools as part of this PR
Note: if you're renaming tools, you *must* add the tool aliases. For more information on how to do so, please refer to the [official docs](https://github.com/github/github-mcp-server/blob/main/docs/tool-renaming.md).
## Lint & tests
<!-- Check what you ran. If not run, explain briefly. -->
- [ ] Linted locally with `./script/lint`
- [ ] Tested locally with `./script/test`
## Docs
- [ ] Not needed
- [ ] Updated (README / docs / examples)
================================================
FILE: .github/workflows/ai-issue-assessment.yml
================================================
name: AI Issue Assessment
on:
issues:
types: [opened, labeled]
jobs:
ai-issue-assessment:
runs-on: ubuntu-latest
permissions:
issues: write
models: read
contents: read
steps:
- name: Checkout
uses: actions/checkout@v6
- name: Run AI assessment
uses: github/ai-assessment-comment-labeler@e3bedc38cfffa9179fe4cee8f7ecc93bffb3fee7 # v1.0.1
with:
token: ${{ secrets.GITHUB_TOKEN }}
ai_review_label: "request ai review"
issue_number: ${{ github.event.issue.number }}
issue_body: ${{ github.event.issue.body }}
prompts_directory: ".github/prompts"
labels_to_prompts_mapping: "bug,bug-report-review.prompt.yml|default,default-issue-review.prompt.yml"
================================================
FILE: .github/workflows/close-inactive-issues.yml
================================================
name: Close inactive issues
on:
schedule:
- cron: "30 8 * * *"
jobs:
close-issues:
runs-on: ubuntu-latest
env:
PR_DAYS_BEFORE_STALE: 30
PR_DAYS_BEFORE_CLOSE: 60
PR_STALE_LABEL: stale
permissions:
issues: write
pull-requests: write
steps:
- uses: actions/stale@v10
with:
days-before-issue-stale: ${{ env.PR_DAYS_BEFORE_STALE }}
days-before-issue-close: ${{ env.PR_DAYS_BEFORE_CLOSE }}
stale-issue-label: ${{ env.PR_STALE_LABEL }}
stale-issue-message: "This issue is stale because it has been open for ${{ env.PR_DAYS_BEFORE_STALE }} days with no activity. Leave a comment to avoid closing this issue in ${{ env.PR_DAYS_BEFORE_CLOSE }} days."
close-issue-message: "This issue was closed because it has been inactive for ${{ env.PR_DAYS_BEFORE_CLOSE }} days since being marked as stale."
days-before-pr-stale: ${{ env.PR_DAYS_BEFORE_STALE }}
days-before-pr-close: ${{ env.PR_DAYS_BEFORE_STALE }}
# Start with the oldest items first
ascending: true
repo-token: ${{ secrets.GITHUB_TOKEN }}
================================================
FILE: .github/workflows/code-scanning.yml
================================================
name: "CodeQL"
run-name: ${{ github.event.inputs.code_scanning_run_name }}
on: [push, pull_request, workflow_dispatch]
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
env:
CODE_SCANNING_REF: ${{ github.event.inputs.code_scanning_ref }}
CODE_SCANNING_BASE_BRANCH: ${{ github.event.inputs.code_scanning_base_branch }}
CODE_SCANNING_IS_ANALYZING_DEFAULT_BRANCH: ${{ github.event.inputs.code_scanning_is_analyzing_default_branch }}
jobs:
analyze:
name: Analyze (${{ matrix.language }})
# Only run on the main repository, not on forks
if: github.repository == 'github/github-mcp-server'
runs-on: ${{ fromJSON(matrix.runner) }}
permissions:
actions: read
contents: read
packages: read
security-events: write
continue-on-error: false
strategy:
fail-fast: false
matrix:
include:
- language: actions
category: /language:actions
build-mode: none
runner: '["ubuntu-22.04"]'
- language: go
category: /language:go
build-mode: autobuild
runner: '["ubuntu-22.04"]'
- language: javascript
category: /language:javascript
build-mode: none
runner: '["ubuntu-22.04"]'
steps:
- name: Checkout repository
uses: actions/checkout@v6
- name: Initialize CodeQL
uses: github/codeql-action/init@v4
with:
languages: ${{ matrix.language }}
build-mode: ${{ matrix.build-mode }}
dependency-caching: ${{ runner.environment == 'github-hosted' }}
queries: "" # Default query suite
packs: github/ccr-${{ matrix.language }}-queries
config: |
paths-ignore:
- third-party
- third-party-licenses.*.md
default-setup:
org:
model-packs: [ ${{ github.event.inputs.code_scanning_codeql_packs }} ]
threat-models: [ ]
- name: Setup proxy for registries
id: proxy
uses: github/codeql-action/start-proxy@v4
with:
registries_credentials: ${{ secrets.GITHUB_REGISTRIES_PROXY }}
language: ${{ matrix.language }}
- name: Configure
uses: github/codeql-action/resolve-environment@v4
id: resolve-environment
with:
language: ${{ matrix.language }}
- name: Setup Go
uses: actions/setup-go@v6
if: matrix.language == 'go' && fromJSON(steps.resolve-environment.outputs.environment).configuration.go.version
with:
go-version: ${{ fromJSON(steps.resolve-environment.outputs.environment).configuration.go.version }}
cache: false
- name: Set up Node.js
if: matrix.language == 'go' || matrix.language == 'javascript'
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
cache-dependency-path: ui/package-lock.json
- name: Build UI
if: matrix.language == 'go'
run: script/build-ui
- name: Autobuild
uses: github/codeql-action/autobuild@v4
- name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@v4
env:
CODEQL_PROXY_HOST: ${{ steps.proxy.outputs.proxy_host }}
CODEQL_PROXY_PORT: ${{ steps.proxy.outputs.proxy_port }}
CODEQL_PROXY_CA_CERTIFICATE: ${{ steps.proxy.outputs.proxy_ca_certificate }}
with:
category: ${{ matrix.category }}
================================================
FILE: .github/workflows/docker-publish.yml
================================================
name: Docker
# This workflow uses actions that are not certified by GitHub.
# They are provided by a third-party and are governed by
# separate terms of service, privacy policy, and support
# documentation.
on:
schedule:
- cron: "27 0 * * *"
push:
branches: ["main", "next"]
# Publish semver tags as releases.
tags: ["v*.*.*"]
pull_request:
branches: ["main", "next"]
workflow_dispatch:
inputs:
description:
required: false
description: "Description of the run."
type: string
default: "Manual run"
env:
# Use docker.io for Docker Hub if empty
REGISTRY: ghcr.io
# github.repository as <account>/<repo>
IMAGE_NAME: ${{ github.repository }}
jobs:
build:
runs-on: ubuntu-latest-xl
permissions:
contents: read
packages: write
# This is used to complete the identity challenge
# with sigstore/fulcio when running outside of PRs.
id-token: write
steps:
- name: Checkout repository
uses: actions/checkout@v6
# Install the cosign tool except on PR
# https://github.com/sigstore/cosign-installer
- name: Install cosign
if: github.event_name != 'pull_request'
uses: sigstore/cosign-installer@ba7bc0a3fef59531c69a25acd34668d6d3fe6f22 #v4.1.0
with:
cosign-release: "v2.2.4"
# Set up BuildKit Docker container builder to be able to build
# multi-platform images and export cache
# https://github.com/docker/setup-buildx-action
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3.12.0
# Login against a Docker registry except on PR
# https://github.com/docker/login-action
- name: Log into registry ${{ env.REGISTRY }}
if: github.event_name != 'pull_request'
uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9 # v3.7.0
with:
registry: ${{ env.REGISTRY }}
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}
# Extract metadata (tags, labels) for Docker
# https://github.com/docker/metadata-action
- name: Extract Docker metadata
id: meta
uses: docker/metadata-action@030e881283bb7a6894de51c315a6bfe6a94e05cf # v6.0.0
with:
images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
tags: |
type=schedule
type=ref,event=branch
type=ref,event=tag
type=ref,event=pr
type=semver,pattern={{version}}
type=semver,pattern={{major}}.{{minor}}
type=semver,pattern={{major}}
type=sha
type=edge
# Custom rule to prevent pre-releases from getting latest tag
type=raw,value=latest,enable=${{ github.ref_type == 'tag' && startsWith(github.ref, 'refs/tags/v') && !contains(github.ref, '-') }}
- name: Go Build Cache for Docker
uses: actions/cache@v5
with:
path: go-build-cache
key: ${{ runner.os }}-go-build-cache-${{ hashFiles('**/go.sum') }}
- name: Inject go-build-cache
uses: reproducible-containers/buildkit-cache-dance@1b8ab18fbda5ad3646e3fcc9ed9dd41ce2f297b4 # v3.3.2
with:
cache-map: |
{
"go-build-cache/apk": "/var/cache/apk",
"go-build-cache/pkg": "/go/pkg/mod",
"go-build-cache/build": "/root/.cache/go-build"
}
# Build and push Docker image with Buildx (don't push on PR)
# https://github.com/docker/build-push-action
- name: Build and push Docker image
id: build-and-push
uses: docker/build-push-action@d08e5c354a6adb9ed34480a06d141179aa583294 # v7.0.0
with:
context: .
push: ${{ github.event_name != 'pull_request' }}
tags: ${{ steps.meta.outputs.tags }}
labels: ${{ steps.meta.outputs.labels }}
cache-from: type=gha
cache-to: type=gha,mode=max
platforms: linux/amd64,linux/arm64
build-args: |
VERSION=${{ github.ref_name }}
# Sign the resulting Docker image digest except on PRs.
# This will only write to the public Rekor transparency log when the Docker
# repository is public to avoid leaking data. If you would like to publish
# transparency data even for private images, pass --force to cosign below.
# https://github.com/sigstore/cosign
- name: Sign the published Docker image
if: ${{ github.event_name != 'pull_request' }}
env:
# https://docs.github.com/en/actions/security-guides/security-hardening-for-github-actions#using-an-intermediate-environment-variable
TAGS: ${{ steps.meta.outputs.tags }}
DIGEST: ${{ steps.build-and-push.outputs.digest }}
# This step uses the identity token to provision an ephemeral certificate
# against the sigstore community Fulcio instance.
run: echo "${TAGS}" | xargs -I {} cosign sign --yes {}@${DIGEST}
================================================
FILE: .github/workflows/docs-check.yml
================================================
name: Documentation Check
on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
permissions:
contents: read
jobs:
docs-check:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v6
- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
cache-dependency-path: ui/package-lock.json
- name: Build UI
run: script/build-ui
- name: Set up Go
uses: actions/setup-go@v6
with:
go-version-file: 'go.mod'
- name: Build docs generator
run: go build -o github-mcp-server ./cmd/github-mcp-server
- name: Generate documentation
run: ./github-mcp-server generate-docs
- name: Check for documentation changes
run: |
if ! git diff --exit-code README.md; then
echo "❌ Documentation is out of date!"
echo ""
echo "The generated documentation differs from what's committed."
echo "Please run the following command to update the documentation:"
echo ""
echo " go run ./cmd/github-mcp-server generate-docs"
echo ""
echo "Then commit the changes."
echo ""
echo "Changes detected:"
git diff README.md
exit 1
else
echo "✅ Documentation is up to date!"
fi
================================================
FILE: .github/workflows/go.yml
================================================
name: Build and Test Go Project
on: [push, pull_request]
permissions:
contents: read
jobs:
build:
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, windows-latest, macos-latest]
runs-on: ${{ matrix.os }}
steps:
- name: Force git to use LF
# This step is required on Windows to work around go mod tidy -diff issues caused by CRLF line endings.
# TODO: replace with a checkout option when https://github.com/actions/checkout/issues/226 is implemented
if: runner.os == 'Windows'
run: |
git config --global core.autocrlf false
git config --global core.eol lf
- name: Check out code
uses: actions/checkout@v6
- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
cache-dependency-path: ui/package-lock.json
- name: Build UI
shell: bash
run: script/build-ui
- name: Set up Go
uses: actions/setup-go@v6
with:
go-version-file: "go.mod"
- name: Tidy dependencies
run: go mod tidy -diff
- name: Run unit tests
shell: bash
run: script/test
- name: Build
run: go build -v ./cmd/github-mcp-server
================================================
FILE: .github/workflows/goreleaser.yml
================================================
name: GoReleaser Release
on:
push:
tags:
- "v*"
permissions:
contents: write
id-token: write
attestations: write
jobs:
release:
runs-on: ubuntu-latest
steps:
- name: Check out code
uses: actions/checkout@v6
- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
cache-dependency-path: ui/package-lock.json
- name: Build UI
run: script/build-ui
- name: Set up Go
uses: actions/setup-go@v6
with:
go-version-file: "go.mod"
- name: Download dependencies
run: go mod download
- name: Run GoReleaser
uses: goreleaser/goreleaser-action@e435ccd777264be153ace6237001ef4d979d3a7a
with:
distribution: goreleaser
# GoReleaser version
version: "~> v2"
# Arguments to pass to GoReleaser
args: release --clean
workdir: .
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- name: Generate signed build provenance attestations for workflow artifacts
uses: actions/attest-build-provenance@v3
with:
subject-path: |
dist/*.tar.gz
dist/*.zip
dist/*.txt
================================================
FILE: .github/workflows/issue-labeler.yml
================================================
name: Label issues for AI review
on:
issues:
types:
- reopened
- opened
jobs:
label_issues:
runs-on: ubuntu-latest
permissions:
issues: write
steps:
- name: Add AI review label to issue
run: gh issue edit "$NUMBER" --add-label "$LABELS"
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
GH_REPO: ${{ github.repository }}
NUMBER: ${{ github.event.issue.number }}
LABELS: "request ai review"
================================================
FILE: .github/workflows/license-check.yml
================================================
# Automatically fix license files on PRs that need updates
# Tries to auto-commit the fix, or comments with instructions if push fails
name: License Check
on:
pull_request:
branches:
- main # Only run when PR targets main
paths:
- "**.go"
- go.mod
- go.sum
- ".github/licenses.tmpl"
- "script/licenses*"
- "third-party-licenses.*.md"
- "third-party/**"
permissions:
contents: write
pull-requests: write
jobs:
license-check:
runs-on: ubuntu-latest
steps:
- name: Check out code
uses: actions/checkout@v6
# Check out the actual PR branch so we can push changes back if needed
- name: Check out PR branch
env:
GH_TOKEN: ${{ github.token }}
run: gh pr checkout ${{ github.event.pull_request.number }}
- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
cache-dependency-path: ui/package-lock.json
- name: Build UI
run: script/build-ui
- name: Set up Go
uses: actions/setup-go@v6
with:
go-version-file: "go.mod"
# actions/setup-go does not setup the installed toolchain to be preferred over the system install,
# which causes go-licenses to raise "Package ... does not have module info" errors.
# For more information, https://github.com/google/go-licenses/issues/244#issuecomment-1885098633
- name: Regenerate licenses
env:
CI: "true"
run: |
export GOROOT=$(go env GOROOT)
export PATH=${GOROOT}/bin:$PATH
./script/licenses
- name: Check for changes
id: changes
continue-on-error: true
run: script/licenses-check
- name: Commit and push fixes
if: steps.changes.outcome == 'failure'
continue-on-error: true
id: push
run: |
git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"
git add third-party-licenses.*.md third-party/
git commit -m "chore: regenerate license files" -m "Auto-generated by license-check workflow"
git push
- name: Check if already commented
if: steps.changes.outcome == 'failure' && steps.push.outcome == 'failure'
id: check_comment
uses: actions/github-script@v8
with:
script: |
const { data: comments } = await github.rest.issues.listComments({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: context.issue.number
});
const alreadyCommented = comments.some(comment =>
comment.user.login === 'github-actions[bot]' &&
comment.body.includes('## ⚠️ License files need updating')
);
core.setOutput('already_commented', alreadyCommented ? 'true' : 'false');
- name: Comment with instructions if cannot push
if: steps.changes.outcome == 'failure' && steps.push.outcome == 'failure' && steps.check_comment.outputs.already_commented == 'false'
uses: actions/github-script@v8
with:
script: |
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: context.issue.number,
body: `## ⚠️ License files need updating
The license files are out of date. I tried to fix them automatically but don't have permission to push to this branch.
**Please run:**
\`\`\`bash
script/licenses
git add third-party-licenses.*.md third-party/
git commit -m "chore: regenerate license files"
git push
\`\`\`
Alternatively, enable "Allow edits by maintainers" in the PR settings so I can fix it automatically.`
});
- name: Fail check if changes needed
if: steps.changes.outcome == 'failure'
run: exit 1
================================================
FILE: .github/workflows/lint.yml
================================================
name: golangci-lint
on:
push:
branches:
- main
pull_request:
permissions:
contents: read
jobs:
golangci:
name: lint
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: "20"
cache: "npm"
cache-dependency-path: ui/package-lock.json
- name: Build UI
run: script/build-ui
- uses: actions/setup-go@v6
with:
go-version: '1.25'
- name: golangci-lint
uses: golangci/golangci-lint-action@v9
with:
# sync with script/lint
version: v2.9
================================================
FILE: .github/workflows/mcp-diff.yml
================================================
name: MCP Server Diff
on:
pull_request:
push:
branches: [main]
tags: ['v*']
permissions:
contents: read
jobs:
mcp-diff:
runs-on: ubuntu-latest
steps:
- name: Check out code
uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Set up Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
- name: Build UI
run: script/build-ui
- name: Run MCP Server Diff
uses: SamMorrowDrums/mcp-server-diff@v2.3.5
with:
setup_go: "true"
install_command: go mod download
start_command: go run ./cmd/github-mcp-server stdio
env_vars: |
GITHUB_PERSONAL_ACCESS_TOKEN=test-token
configurations: |
[
{"name": "default", "args": ""},
{"name": "read-only", "args": "--read-only"},
{"name": "dynamic-toolsets", "args": "--dynamic-toolsets"},
{"name": "read-only+dynamic", "args": "--read-only --dynamic-toolsets"},
{"name": "toolsets-repos", "args": "--toolsets=repos"},
{"name": "toolsets-issues", "args": "--toolsets=issues"},
{"name": "toolsets-context", "args": "--toolsets=context"},
{"name": "toolsets-pull_requests", "args": "--toolsets=pull_requests"},
{"name": "toolsets-repos,issues", "args": "--toolsets=repos,issues"},
{"name": "toolsets-issues,context", "args": "--toolsets=issues,context"},
{"name": "toolsets-all", "args": "--toolsets=all"},
{"name": "tools-get_me", "args": "--tools=get_me"},
{"name": "tools-get_me,list_issues", "args": "--tools=get_me,list_issues"},
{"name": "toolsets-repos+read-only", "args": "--toolsets=repos --read-only"},
{"name": "toolsets-all+dynamic", "args": "--toolsets=all --dynamic-toolsets"},
{"name": "toolsets-repos+dynamic", "args": "--toolsets=repos --dynamic-toolsets"},
{"name": "toolsets-repos,issues+dynamic", "args": "--toolsets=repos,issues --dynamic-toolsets"},
{
"name": "dynamic-tool-calls",
"args": "--dynamic-toolsets",
"custom_messages": [
{"id": 10, "name": "list_toolsets_before", "message": {"jsonrpc": "2.0", "id": 10, "method": "tools/call", "params": {"name": "list_available_toolsets", "arguments": {}}}},
{"id": 11, "name": "get_toolset_tools", "message": {"jsonrpc": "2.0", "id": 11, "method": "tools/call", "params": {"name": "get_toolset_tools", "arguments": {"toolset": "repos"}}}},
{"id": 12, "name": "enable_toolset", "message": {"jsonrpc": "2.0", "id": 12, "method": "tools/call", "params": {"name": "enable_toolset", "arguments": {"toolset": "repos"}}}},
{"id": 13, "name": "list_toolsets_after", "message": {"jsonrpc": "2.0", "id": 13, "method": "tools/call", "params": {"name": "list_available_toolsets", "arguments": {}}}}
]
}
]
- name: Add interpretation note
if: always()
run: |
echo "" >> $GITHUB_STEP_SUMMARY
echo "---" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "ℹ️ **Note:** Differences may be intentional improvements." >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "Common expected differences:" >> $GITHUB_STEP_SUMMARY
echo "- New tools/toolsets added" >> $GITHUB_STEP_SUMMARY
echo "- Tool descriptions updated" >> $GITHUB_STEP_SUMMARY
echo "- Capability changes (intentional improvements)" >> $GITHUB_STEP_SUMMARY
================================================
FILE: .github/workflows/moderator.yml
================================================
name: AI Moderator
on:
issues:
types: [opened]
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
jobs:
spam-detection:
runs-on: ubuntu-latest
permissions:
issues: write
pull-requests: write
models: read
contents: read
steps:
- uses: actions/checkout@v6
- uses: github/ai-moderator@v1
with:
token: ${{ secrets.GITHUB_TOKEN }}
spam-label: 'spam'
ai-label: 'ai-generated'
minimize-detected-comments: true
enable-spam-detection: true
enable-link-spam-detection: true
enable-ai-detection: true
================================================
FILE: .github/workflows/registry-releaser.yml
================================================
name: Publish to MCP Registry
on:
push:
tags: ["v*"] # Triggers on version tags like v1.0.0
workflow_dispatch: # Allow manual triggering
jobs:
publish:
runs-on: ubuntu-latest
permissions:
id-token: write # Required for OIDC authentication
contents: read
steps:
- name: Checkout code
uses: actions/checkout@v6
- name: Setup Go
uses: actions/setup-go@v6
with:
go-version: "stable"
- name: Fetch tags
run: |
if [[ "${{ github.ref_type }}" != "tag" ]]; then
git fetch --tags
else
echo "Skipping tag fetch - already on tag ${{ github.ref_name }}"
fi
- name: Wait for Docker image
run: |
if [[ "${{ github.ref_type }}" == "tag" ]]; then
TAG="${{ github.ref_name }}"
else
TAG=$(git tag --sort=-version:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -n1)
fi
IMAGE="ghcr.io/github/github-mcp-server:$TAG"
for i in {1..10}; do
if docker manifest inspect "$IMAGE" &>/dev/null; then
echo "✅ Docker image ready: $TAG"
break
fi
[ $i -eq 10 ] && { echo "❌ Timeout waiting for $TAG after 5 minutes"; exit 1; }
echo "⏳ Waiting for Docker image ($i/10)..."
sleep 30
done
- name: Install MCP Publisher
run: |
git clone --quiet https://github.com/modelcontextprotocol/registry publisher-repo
cd publisher-repo && make publisher > /dev/null && cd ..
cp publisher-repo/bin/mcp-publisher . && chmod +x mcp-publisher
- name: Update server.json version
run: |
if [[ "${{ github.ref_type }}" == "tag" ]]; then
TAG_VERSION=$(echo "${{ github.ref_name }}" | sed 's/^v//')
else
LATEST_TAG=$(git tag --sort=-version:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -n 1)
[ -z "$LATEST_TAG" ] && { echo "No release tag found"; exit 1; }
TAG_VERSION=$(echo "$LATEST_TAG" | sed 's/^v//')
echo "Using latest tag: $LATEST_TAG"
fi
sed -i "s/\${VERSION}/$TAG_VERSION/g" server.json
echo "Version: $TAG_VERSION"
- name: Validate configuration
run: |
python3 -m json.tool server.json > /dev/null && echo "Configuration valid" || exit 1
- name: Display final server.json
run: |
echo "Final server.json contents:"
cat server.json
- name: Login to MCP Registry (OIDC)
run: ./mcp-publisher login github-oidc
- name: Publish to MCP Registry
run: ./mcp-publisher publish
================================================
FILE: .gitignore
================================================
.idea
cmd/github-mcp-server/github-mcp-server
# VSCode
.vscode/*
!.vscode/launch.json
# Added by goreleaser init:
dist/
__debug_bin*
# Go
vendor
bin/
# macOS
.DS_Store
# binary
github-mcp-server
mcpcurl
e2e.test
.history
conformance-report/
# UI build artifacts
ui/dist/
ui/node_modules/
# Embedded UI assets (built from ui/)
pkg/github/ui_dist/*
!pkg/github/ui_dist/.gitkeep
!pkg/github/ui_dist/.placeholder.html
================================================
FILE: .golangci.yml
================================================
version: "2"
run:
concurrency: 4
tests: true
linters:
enable:
- bodyclose
- gocritic
- gosec
- makezero
- misspell
- modernize
- nakedret
- revive
- errcheck
- staticcheck
- govet
- ineffassign
- intrange
- unused
exclusions:
generated: lax
presets:
- comments
- common-false-positives
- legacy
- std-error-handling
paths:
- third_party$
- builtin$
- examples$
- internal/githubv4mock
rules:
- linters:
- revive
text: "var-naming: avoid package names that conflict with Go standard library package names"
settings:
staticcheck:
checks:
- "all"
- -QF1008
- -ST1000
formatters:
exclusions:
generated: lax
paths:
- third_party$
- builtin$
- examples$
================================================
FILE: .goreleaser.yaml
================================================
version: 2
project_name: github-mcp-server
before:
hooks:
- go mod tidy
- go generate ./...
builds:
- env:
- CGO_ENABLED=0
ldflags:
- -s -w -X main.version={{.Version}} -X main.commit={{.Commit}} -X main.date={{.Date}}
goos:
- linux
- windows
- darwin
main: ./cmd/github-mcp-server
archives:
- formats: tar.gz
# this name template makes the OS and Arch compatible with the results of `uname`.
name_template: >-
{{ .ProjectName }}_
{{- title .Os }}_
{{- if eq .Arch "amd64" }}x86_64
{{- else if eq .Arch "386" }}i386
{{- else }}{{ .Arch }}{{ end }}
{{- if .Arm }}v{{ .Arm }}{{ end }}
# use zip for windows archives
format_overrides:
- goos: windows
formats: zip
changelog:
sort: asc
filters:
exclude:
- "^docs:"
- "^test:"
release:
draft: true
prerelease: auto
name_template: "GitHub MCP Server {{.Version}}"
================================================
FILE: .vscode/launch.json
================================================
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Launch stdio server",
"type": "go",
"request": "launch",
"mode": "auto",
"cwd": "${workspaceFolder}",
"program": "cmd/github-mcp-server/main.go",
"args": ["stdio"],
"console": "integratedTerminal",
},
{
"name": "Launch stdio server (read-only)",
"type": "go",
"request": "launch",
"mode": "auto",
"cwd": "${workspaceFolder}",
"program": "cmd/github-mcp-server/main.go",
"args": ["stdio", "--read-only"],
"console": "integratedTerminal",
},
{
"name": "Launch http server",
"type": "go",
"request": "launch",
"mode": "auto",
"cwd": "${workspaceFolder}",
"program": "cmd/github-mcp-server/main.go",
"args": ["http", "--port", "8082"],
"console": "integratedTerminal",
}
]
}
================================================
FILE: CODE_OF_CONDUCT.md
================================================
# Contributor Covenant Code of Conduct
## Our Pledge
We as members, contributors, and leaders pledge to make participation in our
community a harassment-free experience for everyone, regardless of age, body
size, visible or invisible disability, ethnicity, sex characteristics, gender
identity and expression, level of experience, education, socio-economic status,
nationality, personal appearance, race, religion, or sexual identity
and orientation.
We pledge to act and interact in ways that contribute to an open, welcoming,
diverse, inclusive, and healthy community.
## Our Standards
Examples of behavior that contributes to a positive environment for our
community include:
* Demonstrating empathy and kindness toward other people
* Being respectful of differing opinions, viewpoints, and experiences
* Giving and gracefully accepting constructive feedback
* Accepting responsibility and apologizing to those affected by our mistakes,
and learning from the experience
* Focusing on what is best not just for us as individuals, but for the
overall community
Examples of unacceptable behavior include:
* The use of sexualized language or imagery, and sexual attention or
advances of any kind
* Trolling, insulting or derogatory comments, and personal or political attacks
* Public or private harassment
* Publishing others' private information, such as a physical or email
address, without their explicit permission
* Other conduct which could reasonably be considered inappropriate in a
professional setting
## Enforcement Responsibilities
Community leaders are responsible for clarifying and enforcing our standards of
acceptable behavior and will take appropriate and fair corrective action in
response to any behavior that they deem inappropriate, threatening, offensive,
or harmful.
Community leaders have the right and responsibility to remove, edit, or reject
comments, commits, code, wiki edits, issues, and other contributions that are
not aligned to this Code of Conduct, and will communicate reasons for moderation
decisions when appropriate.
## Scope
This Code of Conduct applies within all community spaces, and also applies when
an individual is officially representing the community in public spaces.
Examples of representing our community include using an official e-mail address,
posting via an official social media account, or acting as an appointed
representative at an online or offline event.
## Enforcement
Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported to the community leaders responsible for enforcement at
GitHub.
All complaints will be reviewed and investigated promptly and fairly.
All community leaders are obligated to respect the privacy and security of the
reporter of any incident.
## Enforcement Guidelines
Community leaders will follow these Community Impact Guidelines in determining
the consequences for any action they deem in violation of this Code of Conduct:
### 1. Correction
**Community Impact**: Use of inappropriate language or other behavior deemed
unprofessional or unwelcome in the community.
**Consequence**: A private, written warning from community leaders, providing
clarity around the nature of the violation and an explanation of why the
behavior was inappropriate. A public apology may be requested.
### 2. Warning
**Community Impact**: A violation through a single incident or series
of actions.
**Consequence**: A warning with consequences for continued behavior. No
interaction with the people involved, including unsolicited interaction with
those enforcing the Code of Conduct, for a specified period of time. This
includes avoiding interactions in community spaces as well as external channels
like social media. Violating these terms may lead to a temporary or
permanent ban.
### 3. Temporary Ban
**Community Impact**: A serious violation of community standards, including
sustained inappropriate behavior.
**Consequence**: A temporary ban from any sort of interaction or public
communication with the community for a specified period of time. No public or
private interaction with the people involved, including unsolicited interaction
with those enforcing the Code of Conduct, is allowed during this period.
Violating these terms may lead to a permanent ban.
### 4. Permanent Ban
**Community Impact**: Demonstrating a pattern of violation of community
standards, including sustained inappropriate behavior, harassment of an
individual, or aggression toward or disparagement of classes of individuals.
**Consequence**: A permanent ban from any sort of public interaction within
the community.
## Attribution
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
version 2.0, available at
https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
Community Impact Guidelines were inspired by [Mozilla's code of conduct
enforcement ladder](https://github.com/mozilla/diversity).
[homepage]: https://www.contributor-covenant.org
For answers to common questions about this code of conduct, see the FAQ at
https://www.contributor-covenant.org/faq. Translations are available at
https://www.contributor-covenant.org/translations.
================================================
FILE: CONTRIBUTING.md
================================================
## Contributing
[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.yml
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).
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.
## What we're looking for
We can't guarantee that every tool, feature, or pull request will be approved or merged. Our focus is on supporting high-quality, high-impact capabilities that advance agentic workflows and deliver clear value to developers.
To increase the chances your request is accepted:
* Include real use cases or examples that demonstrate practical value
* Please create an issue outlining the scenario and potential impact, so we can triage it promptly and prioritize accordingly.
* If your request stalls, you can open a Discussion post and link to your issue or PR
* We actively revisit requests that gain strong community engagement (👍s, comments, or evidence of real-world use)
Thanks for contributing and for helping us build toolsets that are truly valuable!
## Prerequisites for running and testing code
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)
2. [Install golangci-lint v2](https://golangci-lint.run/welcome/install/#local-installation)
## Submitting a pull request
1. [Fork][fork] and clone the repository
2. Make sure the tests pass on your machine: `go test -v ./...`
3. Make sure linter passes on your machine: `golangci-lint run`
4. Create a new branch: `git checkout -b my-branch-name`
5. Add your changes and tests, and make sure the Action workflows still pass
- Run linter: `script/lint`
- Update snapshots and run tests: `UPDATE_TOOLSNAPS=true go test ./...`
- Update readme documentation: `script/generate-docs`
- If renaming a tool, add a deprecation alias (see [Tool Renaming Guide](docs/tool-renaming.md))
- For toolset and icon configuration, see [Toolsets and Icons Guide](docs/toolsets-and-icons.md)
6. Push to your fork and [submit a pull request][pr] targeting the `main` branch
7. 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).
## Resources
- [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)
================================================
FILE: Dockerfile
================================================
FROM node:20-alpine@sha256:09e2b3d9726018aecf269bd35325f46bf75046a643a66d28360ec71132750ec8 AS ui-build
WORKDIR /app
COPY ui/package*.json ./ui/
RUN cd ui && npm ci
COPY ui/ ./ui/
# Create output directory and build - vite outputs directly to pkg/github/ui_dist/
RUN mkdir -p ./pkg/github/ui_dist && \
cd ui && npm run build
FROM golang:1.25.8-alpine@sha256:8e02eb337d9e0ea459e041f1ee5eece41cbb61f1d83e7d883a3e2fb4862063fa AS build
ARG VERSION="dev"
# Set the working directory
WORKDIR /build
# Install git
RUN --mount=type=cache,target=/var/cache/apk \
apk add git
# Copy source code (including ui_dist placeholder)
COPY . .
# Copy built UI assets over the placeholder
COPY --from=ui-build /app/pkg/github/ui_dist/* ./pkg/github/ui_dist/
# Build the server
RUN --mount=type=cache,target=/go/pkg/mod \
--mount=type=cache,target=/root/.cache/go-build \
CGO_ENABLED=0 go build -ldflags="-s -w -X main.version=${VERSION} -X main.commit=$(git rev-parse HEAD) -X main.date=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
-o /bin/github-mcp-server ./cmd/github-mcp-server
# Make a stage to run the app
FROM gcr.io/distroless/base-debian12@sha256:937c7eaaf6f3f2d38a1f8c4aeff326f0c56e4593ea152e9e8f74d976dde52f56
# Add required MCP server annotation
LABEL io.modelcontextprotocol.server.name="io.github.github/github-mcp-server"
# Set the working directory
WORKDIR /server
# Copy the binary from the build stage
COPY --from=build /bin/github-mcp-server .
# Expose the default port
EXPOSE 8082
# Set the entrypoint to the server binary
ENTRYPOINT ["/server/github-mcp-server"]
# Default arguments for ENTRYPOINT
CMD ["stdio"]
================================================
FILE: LICENSE
================================================
MIT License
Copyright (c) 2025 GitHub
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
================================================
FILE: README.md
================================================
[](https://goreportcard.com/report/github.com/github/github-mcp-server)
# GitHub MCP Server
The GitHub MCP Server connects AI tools directly to GitHub's platform. This gives AI agents, assistants, and chatbots the ability to read repositories and code files, manage issues and PRs, analyze code, and automate workflows. All through natural language interactions.
### Use Cases
- Repository Management: Browse and query code, search files, analyze commits, and understand project structure across any repository you have access to.
- Issue & PR Automation: Create, update, and manage issues and pull requests. Let AI help triage bugs, review code changes, and maintain project boards.
- CI/CD & Workflow Intelligence: Monitor GitHub Actions workflow runs, analyze build failures, manage releases, and get insights into your development pipeline.
- Code Analysis: Examine security findings, review Dependabot alerts, understand code patterns, and get comprehensive insights into your codebase.
- Team Collaboration: Access discussions, manage notifications, analyze team activity, and streamline processes for your team.
Built for developers who want to connect their AI tools to GitHub context and capabilities, from simple natural language queries to complex multi-step agent workflows.
---
## Remote GitHub MCP Server
[](https://insiders.vscode.dev/redirect/mcp/install?name=github&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2F%22%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=github&config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fapi.githubcopilot.com%2Fmcp%2F%22%7D&quality=insiders)
The remote GitHub MCP Server is hosted by GitHub and provides the easiest method for getting up and running. If your MCP host does not support remote MCP servers, don't worry! You can use the [local version of the GitHub MCP Server](https://github.com/github/github-mcp-server?tab=readme-ov-file#local-github-mcp-server) instead.
### Prerequisites
1. A compatible MCP host with remote server support (VS Code 1.101+, Claude Desktop, Cursor, Windsurf, etc.)
2. Any applicable [policies enabled](https://github.com/github/github-mcp-server/blob/main/docs/policies-and-governance.md)
### Install in VS Code
For quick installation, use one of the one-click install buttons above. Once you complete that flow, toggle Agent mode (located by the Copilot Chat text input) and the server will start. Make sure you're using [VS Code 1.101](https://code.visualstudio.com/updates/v1_101) or [later](https://code.visualstudio.com/updates) for remote MCP and OAuth support.
Alternatively, to manually configure VS Code, choose the appropriate JSON block from the examples below and add it to your host configuration:
<table>
<tr><th>Using OAuth</th><th>Using a GitHub PAT</th></tr>
<tr><th align=left colspan=2>VS Code (version 1.101 or greater)</th></tr>
<tr valign=top>
<td>
```json
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
}
}
}
```
</td>
<td>
```json
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer ${input:github_mcp_pat}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "github_mcp_pat",
"description": "GitHub Personal Access Token",
"password": true
}
]
}
```
</td>
</tr>
</table>
### Install in other MCP hosts
- **[Copilot CLI](/docs/installation-guides/install-copilot-cli.md)** - Installation guide for GitHub Copilot CLI
- **[GitHub Copilot in other IDEs](/docs/installation-guides/install-other-copilot-ides.md)** - Installation for JetBrains, Visual Studio, Eclipse, and Xcode with GitHub Copilot
- **[Claude Applications](/docs/installation-guides/install-claude.md)** - Installation guide for Claude Desktop and Claude Code CLI
- **[Codex](/docs/installation-guides/install-codex.md)** - Installation guide for OpenAI Codex
- **[Cursor](/docs/installation-guides/install-cursor.md)** - Installation guide for Cursor IDE
- **[Windsurf](/docs/installation-guides/install-windsurf.md)** - Installation guide for Windsurf IDE
- **[Rovo Dev CLI](/docs/installation-guides/install-rovo-dev-cli.md)** - Installation guide for Rovo Dev CLI
> **Note:** Each MCP host application needs to configure a GitHub App or OAuth App to support remote access via OAuth. Any host application that supports remote MCP servers should support the remote GitHub server with PAT authentication. Configuration details and support levels vary by host. Make sure to refer to the host application's documentation for more info.
### Configuration
#### Toolset configuration
See [Remote Server Documentation](docs/remote-server.md) for full details on remote server configuration, toolsets, headers, and advanced usage. This file provides comprehensive instructions and examples for connecting, customizing, and installing the remote GitHub MCP Server in VS Code and other MCP hosts.
When no toolsets are specified, [default toolsets](#default-toolset) are used.
#### Insiders Mode
> **Try new features early!** The remote server offers an insiders version with early access to new features and experimental tools.
<table>
<tr><th>Using URL Path</th><th>Using Header</th></tr>
<tr valign=top>
<td>
```json
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/insiders"
}
}
}
```
</td>
<td>
```json
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"X-MCP-Insiders": "true"
}
}
}
}
```
</td>
</tr>
</table>
See [Remote Server Documentation](docs/remote-server.md#insiders-mode) for more details and examples, and [Insiders Features](docs/insiders-features.md) for a full list of what's available.
#### GitHub Enterprise
##### GitHub Enterprise Cloud with data residency (ghe.com)
GitHub Enterprise Cloud can also make use of the remote server.
Example for `https://octocorp.ghe.com` with GitHub PAT token:
```
{
...
"github-octocorp": {
"type": "http",
"url": "https://copilot-api.octocorp.ghe.com/mcp",
"headers": {
"Authorization": "Bearer ${input:github_mcp_pat}"
}
},
...
}
```
> **Note:** When using OAuth with GitHub Enterprise with VS Code and GitHub Copilot, you also need to configure your VS Code settings to point to your GitHub Enterprise instance - see [Authenticate from VS Code](https://docs.github.com/en/enterprise-cloud@latest/copilot/how-tos/configure-personal-settings/authenticate-to-ghecom)
##### GitHub Enterprise Server
GitHub Enterprise Server does not support remote server hosting. Please refer to [GitHub Enterprise Server and Enterprise Cloud with data residency (ghe.com)](#github-enterprise-server-and-enterprise-cloud-with-data-residency-ghecom) from the local server configuration.
---
## Local GitHub MCP Server
[](https://insiders.vscode.dev/redirect/mcp/install?name=github&inputs=%5B%7B%22id%22%3A%22github_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22GitHub%20Personal%20Access%20Token%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22GITHUB_PERSONAL_ACCESS_TOKEN%22%2C%22ghcr.io%2Fgithub%2Fgithub-mcp-server%22%5D%2C%22env%22%3A%7B%22GITHUB_PERSONAL_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agithub_token%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=github&inputs=%5B%7B%22id%22%3A%22github_token%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22GitHub%20Personal%20Access%20Token%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22GITHUB_PERSONAL_ACCESS_TOKEN%22%2C%22ghcr.io%2Fgithub%2Fgithub-mcp-server%22%5D%2C%22env%22%3A%7B%22GITHUB_PERSONAL_ACCESS_TOKEN%22%3A%22%24%7Binput%3Agithub_token%7D%22%7D%7D&quality=insiders)
### Prerequisites
1. To run the server in a container, you will need to have [Docker](https://www.docker.com/) installed.
2. Once Docker is installed, you will also need to ensure Docker is running. The Docker image is available at `ghcr.io/github/github-mcp-server`. The image is public; if you get errors on pull, you may have an expired token and need to `docker logout ghcr.io`.
3. Lastly you will need to [Create a GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new).
The MCP server can use many of the GitHub APIs, so enable the permissions that you feel comfortable granting your AI tools (to learn more about access tokens, please check out the [documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)).
<details><summary><b>Handling PATs Securely</b></summary>
### Environment Variables (Recommended)
To keep your GitHub PAT secure and reusable across different MCP hosts:
1. **Store your PAT in environment variables**
```bash
export GITHUB_PAT=your_token_here
```
Or create a `.env` file:
```env
GITHUB_PAT=your_token_here
```
2. **Protect your `.env` file**
```bash
# Add to .gitignore to prevent accidental commits
echo ".env" >> .gitignore
```
3. **Reference the token in configurations**
```bash
# CLI usage
claude mcp update github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PAT
# In config files (where supported)
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "$GITHUB_PAT"
}
```
> **Note**: Environment variable support varies by host app and IDE. Some applications (like Windsurf) require hardcoded tokens in config files.
### Token Security Best Practices
- **Minimum scopes**: Only grant necessary permissions
- `repo` - Repository operations
- `read:packages` - Docker image access
- `read:org` - Organization team access
- **Separate tokens**: Use different PATs for different projects/environments
- **Regular rotation**: Update tokens periodically
- **Never commit**: Keep tokens out of version control
- **File permissions**: Restrict access to config files containing tokens
```bash
chmod 600 ~/.your-app/config.json
```
</details>
### GitHub Enterprise Server and Enterprise Cloud with data residency (ghe.com)
The flag `--gh-host` and the environment variable `GITHUB_HOST` can be used to set
the hostname for GitHub Enterprise Server or GitHub Enterprise Cloud with data residency.
- For GitHub Enterprise Server, prefix the hostname with the `https://` URI scheme, as it otherwise defaults to `http://`, which GitHub Enterprise Server does not support.
- For GitHub Enterprise Cloud with data residency, use `https://YOURSUBDOMAIN.ghe.com` as the hostname.
``` json
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"-e",
"GITHUB_HOST",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
"GITHUB_HOST": "https://<your GHES or ghe.com domain name>"
}
}
```
## Installation
### Install in GitHub Copilot on VS Code
For quick installation, use one of the one-click install buttons above. Once you complete that flow, toggle Agent mode (located by the Copilot Chat text input) and the server will start.
More about using MCP server tools in VS Code's [agent mode documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
Install in GitHub Copilot on other IDEs (JetBrains, Visual Studio, Eclipse, etc.)
Add the following JSON block to your IDE's MCP settings.
```json
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "github_token",
"description": "GitHub Personal Access Token",
"password": true
}
],
"servers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
}
}
}
}
}
```
Optionally, you can add a similar example (i.e. without the mcp key) to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with other host applications that accept the same format.
<details>
<summary><b>Example JSON block without the MCP key included</b></summary>
<br>
```json
{
"inputs": [
{
"type": "promptString",
"id": "github_token",
"description": "GitHub Personal Access Token",
"password": true
}
],
"servers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
}
}
}
}
```
</details>
### Install in Other MCP Hosts
For other MCP host applications, please refer to our installation guides:
- **[Copilot CLI](docs/installation-guides/install-copilot-cli.md)** - Installation guide for GitHub Copilot CLI
- **[GitHub Copilot in other IDEs](/docs/installation-guides/install-other-copilot-ides.md)** - Installation for JetBrains, Visual Studio, Eclipse, and Xcode with GitHub Copilot
- **[Claude Code & Claude Desktop](docs/installation-guides/install-claude.md)** - Installation guide for Claude Code and Claude Desktop
- **[Cursor](docs/installation-guides/install-cursor.md)** - Installation guide for Cursor IDE
- **[Google Gemini CLI](docs/installation-guides/install-gemini-cli.md)** - Installation guide for Google Gemini CLI
- **[Windsurf](docs/installation-guides/install-windsurf.md)** - Installation guide for Windsurf IDE
For a complete overview of all installation options, see our **[Installation Guides Index](docs/installation-guides)**.
> **Note:** Any host application that supports local MCP servers should be able to access the local GitHub MCP server. However, the specific configuration process, syntax and stability of the integration will vary by host application. While many may follow a similar format to the examples above, this is not guaranteed. Please refer to your host application's documentation for the correct MCP configuration syntax and setup process.
### Build from source
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:
```JSON
{
"mcp": {
"servers": {
"github": {
"command": "/path/to/github-mcp-server",
"args": ["stdio"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
}
```
### CLI utilities
The `github-mcp-server` binary includes a few CLI subcommands that are helpful for debugging and exploring the server.
- `github-mcp-server tool-search "<query>"` searches tools by name, description, and input parameter names. Use `--max-results` to return more matches.
Example (color output requires a TTY; use `docker run -t` (or `-it`) when running in Docker):
```bash
docker run -it --rm ghcr.io/github/github-mcp-server tool-search "issue" --max-results 5
github-mcp-server tool-search "issue" --max-results 5
```
## Tool Configuration
The GitHub MCP Server supports enabling or disabling specific groups of functionalities via the `--toolsets` flag. This allows you to control which GitHub API capabilities are available to your AI tools. Enabling only the toolsets that you need can help the LLM with tool choice and reduce the context size.
_Toolsets are not limited to Tools. Relevant MCP Resources and Prompts are also included where applicable._
When no toolsets are specified, [default toolsets](#default-toolset) are used.
> **Looking for examples?** See the [Server Configuration Guide](./docs/server-configuration.md) for common recipes like minimal setups, read-only mode, and combining tools with toolsets.
#### Specifying Toolsets
To specify toolsets you want available to the LLM, you can pass an allow-list in two ways:
1. **Using Command Line Argument**:
```bash
github-mcp-server --toolsets repos,issues,pull_requests,actions,code_security
```
2. **Using Environment Variable**:
```bash
GITHUB_TOOLSETS="repos,issues,pull_requests,actions,code_security" ./github-mcp-server
```
The environment variable `GITHUB_TOOLSETS` takes precedence over the command line argument if both are provided.
#### Specifying Individual Tools
You can also configure specific tools using the `--tools` flag. Tools can be used independently or combined with toolsets and dynamic toolsets discovery for fine-grained control.
1. **Using Command Line Argument**:
```bash
github-mcp-server --tools get_file_contents,issue_read,create_pull_request
```
2. **Using Environment Variable**:
```bash
GITHUB_TOOLS="get_file_contents,issue_read,create_pull_request" ./github-mcp-server
```
3. **Combining with Toolsets** (additive):
```bash
github-mcp-server --toolsets repos,issues --tools get_gist
```
This registers all tools from `repos` and `issues` toolsets, plus `get_gist`.
4. **Combining with Dynamic Toolsets** (additive):
```bash
github-mcp-server --tools get_file_contents --dynamic-toolsets
```
This registers `get_file_contents` plus the dynamic toolset tools (`enable_toolset`, `list_available_toolsets`, `get_toolset_tools`).
**Important Notes:**
- Tools, toolsets, and dynamic toolsets can all be used together
- Read-only mode takes priority: write tools are skipped if `--read-only` is set, even if explicitly requested via `--tools`
- Tool names must match exactly (e.g., `get_file_contents`, not `getFileContents`). Invalid tool names will cause the server to fail at startup with an error message
- When tools are renamed, old names are preserved as aliases for backward compatibility. See [Deprecated Tool Aliases](docs/deprecated-tool-aliases.md) for details.
### Using Toolsets With Docker
When using Docker, you can pass the toolsets as environment variables:
```bash
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
-e GITHUB_TOOLSETS="repos,issues,pull_requests,actions,code_security" \
ghcr.io/github/github-mcp-server
```
### Using Tools With Docker
When using Docker, you can pass specific tools as environment variables. You can also combine tools with toolsets:
```bash
# Tools only
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
-e GITHUB_TOOLS="get_file_contents,issue_read,create_pull_request" \
ghcr.io/github/github-mcp-server
# Tools combined with toolsets (additive)
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
-e GITHUB_TOOLSETS="repos,issues" \
-e GITHUB_TOOLS="get_gist" \
ghcr.io/github/github-mcp-server
```
### Special toolsets
#### "all" toolset
The special toolset `all` can be provided to enable all available toolsets regardless of any other configuration:
```bash
./github-mcp-server --toolsets all
```
Or using the environment variable:
```bash
GITHUB_TOOLSETS="all" ./github-mcp-server
```
#### "default" toolset
The default toolset `default` is the configuration that gets passed to the server if no toolsets are specified.
The default configuration is:
- context
- repos
- issues
- pull_requests
- users
To keep the default configuration and add additional toolsets:
```bash
GITHUB_TOOLSETS="default,stargazers" ./github-mcp-server
```
### Insiders Mode
The local GitHub MCP Server offers an insiders version with early access to new features and experimental tools.
1. **Using Command Line Argument**:
```bash
./github-mcp-server --insiders
```
2. **Using Environment Variable**:
```bash
GITHUB_INSIDERS=true ./github-mcp-server
```
When using Docker:
```bash
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
-e GITHUB_INSIDERS=true \
ghcr.io/github/github-mcp-server
```
### Available Toolsets
The following sets of tools are available:
<!-- START AUTOMATED TOOLSETS -->
| | Toolset | Description |
| --- | ----------------------- | ------------------------------------------------------------- |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/person-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/person-light.png"><img src="pkg/octicons/icons/person-light.png" width="20" height="20" alt="person"></picture> | `context` | **Strongly recommended**: Tools that provide context about the current user and GitHub context you are operating in |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/workflow-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/workflow-light.png"><img src="pkg/octicons/icons/workflow-light.png" width="20" height="20" alt="workflow"></picture> | `actions` | GitHub Actions workflows and CI/CD operations |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/codescan-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/codescan-light.png"><img src="pkg/octicons/icons/codescan-light.png" width="20" height="20" alt="codescan"></picture> | `code_security` | Code security related tools, such as GitHub Code Scanning |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/copilot-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/copilot-light.png"><img src="pkg/octicons/icons/copilot-light.png" width="20" height="20" alt="copilot"></picture> | `copilot` | Copilot related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/dependabot-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/dependabot-light.png"><img src="pkg/octicons/icons/dependabot-light.png" width="20" height="20" alt="dependabot"></picture> | `dependabot` | Dependabot tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/comment-discussion-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/comment-discussion-light.png"><img src="pkg/octicons/icons/comment-discussion-light.png" width="20" height="20" alt="comment-discussion"></picture> | `discussions` | GitHub Discussions related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/logo-gist-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/logo-gist-light.png"><img src="pkg/octicons/icons/logo-gist-light.png" width="20" height="20" alt="logo-gist"></picture> | `gists` | GitHub Gist related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/git-branch-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/git-branch-light.png"><img src="pkg/octicons/icons/git-branch-light.png" width="20" height="20" alt="git-branch"></picture> | `git` | GitHub Git API related tools for low-level Git operations |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/issue-opened-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/issue-opened-light.png"><img src="pkg/octicons/icons/issue-opened-light.png" width="20" height="20" alt="issue-opened"></picture> | `issues` | GitHub Issues related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/tag-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/tag-light.png"><img src="pkg/octicons/icons/tag-light.png" width="20" height="20" alt="tag"></picture> | `labels` | GitHub Labels related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/bell-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/bell-light.png"><img src="pkg/octicons/icons/bell-light.png" width="20" height="20" alt="bell"></picture> | `notifications` | GitHub Notifications related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/organization-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/organization-light.png"><img src="pkg/octicons/icons/organization-light.png" width="20" height="20" alt="organization"></picture> | `orgs` | GitHub Organization related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/project-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/project-light.png"><img src="pkg/octicons/icons/project-light.png" width="20" height="20" alt="project"></picture> | `projects` | GitHub Projects related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/git-pull-request-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/git-pull-request-light.png"><img src="pkg/octicons/icons/git-pull-request-light.png" width="20" height="20" alt="git-pull-request"></picture> | `pull_requests` | GitHub Pull Request related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/repo-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/repo-light.png"><img src="pkg/octicons/icons/repo-light.png" width="20" height="20" alt="repo"></picture> | `repos` | GitHub Repository related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/shield-lock-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/shield-lock-light.png"><img src="pkg/octicons/icons/shield-lock-light.png" width="20" height="20" alt="shield-lock"></picture> | `secret_protection` | Secret protection related tools, such as GitHub Secret Scanning |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/shield-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/shield-light.png"><img src="pkg/octicons/icons/shield-light.png" width="20" height="20" alt="shield"></picture> | `security_advisories` | Security advisories related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/star-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/star-light.png"><img src="pkg/octicons/icons/star-light.png" width="20" height="20" alt="star"></picture> | `stargazers` | GitHub Stargazers related tools |
| <picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/people-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/people-light.png"><img src="pkg/octicons/icons/people-light.png" width="20" height="20" alt="people"></picture> | `users` | GitHub User related tools |
<!-- END AUTOMATED TOOLSETS -->
### Additional Toolsets in Remote GitHub MCP Server
| Toolset | Description |
| ----------------------- | ------------------------------------------------------------- |
| `copilot` | Copilot related tools (e.g. Copilot Coding Agent) |
| `copilot_spaces` | Copilot Spaces related tools |
| `github_support_docs_search` | Search docs to answer GitHub product and support questions |
## Tools
<!-- START AUTOMATED TOOLS -->
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/workflow-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/workflow-light.png"><img src="pkg/octicons/icons/workflow-light.png" width="20" height="20" alt="workflow"></picture> Actions</summary>
- **actions_get** - Get details of GitHub Actions resources (workflows, workflow runs, jobs, and artifacts)
- **Required OAuth Scopes**: `repo`
- `method`: The method to execute (string, required)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `resource_id`: The unique identifier of the resource. This will vary based on the "method" provided, so ensure you provide the correct ID:
- Provide a workflow ID or workflow file name (e.g. ci.yaml) for 'get_workflow' method.
- Provide a workflow run ID for 'get_workflow_run', 'get_workflow_run_usage', and 'get_workflow_run_logs_url' methods.
- Provide an artifact ID for 'download_workflow_run_artifact' method.
- Provide a job ID for 'get_workflow_job' method.
(string, required)
- **actions_list** - List GitHub Actions workflows in a repository
- **Required OAuth Scopes**: `repo`
- `method`: The action to perform (string, required)
- `owner`: Repository owner (string, required)
- `page`: Page number for pagination (default: 1) (number, optional)
- `per_page`: Results per page for pagination (default: 30, max: 100) (number, optional)
- `repo`: Repository name (string, required)
- `resource_id`: The unique identifier of the resource. This will vary based on the "method" provided, so ensure you provide the correct ID:
- Do not provide any resource ID for 'list_workflows' method.
- Provide a workflow ID or workflow file name (e.g. ci.yaml) for 'list_workflow_runs' method, or omit to list all workflow runs in the repository.
- Provide a workflow run ID for 'list_workflow_jobs' and 'list_workflow_run_artifacts' methods.
(string, optional)
- `workflow_jobs_filter`: Filters for workflow jobs. **ONLY** used when method is 'list_workflow_jobs' (object, optional)
- `workflow_runs_filter`: Filters for workflow runs. **ONLY** used when method is 'list_workflow_runs' (object, optional)
- **actions_run_trigger** - Trigger GitHub Actions workflow actions
- **Required OAuth Scopes**: `repo`
- `inputs`: Inputs the workflow accepts. Only used for 'run_workflow' method. (object, optional)
- `method`: The method to execute (string, required)
- `owner`: Repository owner (string, required)
- `ref`: The git reference for the workflow. The reference can be a branch or tag name. Required for 'run_workflow' method. (string, optional)
- `repo`: Repository name (string, required)
- `run_id`: The ID of the workflow run. Required for all methods except 'run_workflow'. (number, optional)
- `workflow_id`: The workflow ID (numeric) or workflow file name (e.g., main.yml, ci.yaml). Required for 'run_workflow' method. (string, optional)
- **get_job_logs** - Get GitHub Actions workflow job logs
- **Required OAuth Scopes**: `repo`
- `failed_only`: When true, gets logs for all failed jobs in the workflow run specified by run_id. Requires run_id to be provided. (boolean, optional)
- `job_id`: The unique identifier of the workflow job. Required when getting logs for a single job. (number, optional)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `return_content`: Returns actual log content instead of URLs (boolean, optional)
- `run_id`: The unique identifier of the workflow run. Required when failed_only is true to get logs for all failed jobs in the run. (number, optional)
- `tail_lines`: Number of lines to return from the end of the log (number, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/codescan-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/codescan-light.png"><img src="pkg/octicons/icons/codescan-light.png" width="20" height="20" alt="codescan"></picture> Code Security</summary>
- **get_code_scanning_alert** - Get code scanning alert
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `alertNumber`: The number of the alert. (number, required)
- `owner`: The owner of the repository. (string, required)
- `repo`: The name of the repository. (string, required)
- **list_code_scanning_alerts** - List code scanning alerts
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `owner`: The owner of the repository. (string, required)
- `ref`: The Git reference for the results you want to list. (string, optional)
- `repo`: The name of the repository. (string, required)
- `severity`: Filter code scanning alerts by severity (string, optional)
- `state`: Filter code scanning alerts by state. Defaults to open (string, optional)
- `tool_name`: The name of the tool used for code scanning. (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/person-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/person-light.png"><img src="pkg/octicons/icons/person-light.png" width="20" height="20" alt="person"></picture> Context</summary>
- **get_me** - Get my user profile
- No parameters required
- **get_team_members** - Get team members
- **Required OAuth Scopes**: `read:org`
- **Accepted OAuth Scopes**: `admin:org`, `read:org`, `write:org`
- `org`: Organization login (owner) that contains the team. (string, required)
- `team_slug`: Team slug (string, required)
- **get_teams** - Get teams
- **Required OAuth Scopes**: `read:org`
- **Accepted OAuth Scopes**: `admin:org`, `read:org`, `write:org`
- `user`: Username to get teams for. If not provided, uses the authenticated user. (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/copilot-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/copilot-light.png"><img src="pkg/octicons/icons/copilot-light.png" width="20" height="20" alt="copilot"></picture> Copilot</summary>
- **assign_copilot_to_issue** - Assign Copilot to issue
- **Required OAuth Scopes**: `repo`
- `base_ref`: Git reference (e.g., branch) that the agent will start its work from. If not specified, defaults to the repository's default branch (string, optional)
- `custom_instructions`: Optional custom instructions to guide the agent beyond the issue body. Use this to provide additional context, constraints, or guidance that is not captured in the issue description (string, optional)
- `issue_number`: Issue number (number, required)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- **request_copilot_review** - Request Copilot review
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `pullNumber`: Pull request number (number, required)
- `repo`: Repository name (string, required)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/dependabot-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/dependabot-light.png"><img src="pkg/octicons/icons/dependabot-light.png" width="20" height="20" alt="dependabot"></picture> Dependabot</summary>
- **get_dependabot_alert** - Get dependabot alert
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `alertNumber`: The number of the alert. (number, required)
- `owner`: The owner of the repository. (string, required)
- `repo`: The name of the repository. (string, required)
- **list_dependabot_alerts** - List dependabot alerts
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `owner`: The owner of the repository. (string, required)
- `repo`: The name of the repository. (string, required)
- `severity`: Filter dependabot alerts by severity (string, optional)
- `state`: Filter dependabot alerts by state. Defaults to open (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/comment-discussion-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/comment-discussion-light.png"><img src="pkg/octicons/icons/comment-discussion-light.png" width="20" height="20" alt="comment-discussion"></picture> Discussions</summary>
- **get_discussion** - Get discussion
- **Required OAuth Scopes**: `repo`
- `discussionNumber`: Discussion Number (number, required)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- **get_discussion_comments** - Get discussion comments
- **Required OAuth Scopes**: `repo`
- `after`: Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. (string, optional)
- `discussionNumber`: Discussion Number (number, required)
- `owner`: Repository owner (string, required)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name (string, required)
- **list_discussion_categories** - List discussion categories
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `repo`: Repository name. If not provided, discussion categories will be queried at the organisation level. (string, optional)
- **list_discussions** - List discussions
- **Required OAuth Scopes**: `repo`
- `after`: Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. (string, optional)
- `category`: Optional filter by discussion category ID. If provided, only discussions with this category are listed. (string, optional)
- `direction`: Order direction. (string, optional)
- `orderBy`: Order discussions by field. If provided, the 'direction' also needs to be provided. (string, optional)
- `owner`: Repository owner (string, required)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name. If not provided, discussions will be queried at the organisation level. (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/logo-gist-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/logo-gist-light.png"><img src="pkg/octicons/icons/logo-gist-light.png" width="20" height="20" alt="logo-gist"></picture> Gists</summary>
- **create_gist** - Create Gist
- **Required OAuth Scopes**: `gist`
- `content`: Content for simple single-file gist creation (string, required)
- `description`: Description of the gist (string, optional)
- `filename`: Filename for simple single-file gist creation (string, required)
- `public`: Whether the gist is public (boolean, optional)
- **get_gist** - Get Gist Content
- `gist_id`: The ID of the gist (string, required)
- **list_gists** - List Gists
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `since`: Only gists updated after this time (ISO 8601 timestamp) (string, optional)
- `username`: GitHub username (omit for authenticated user's gists) (string, optional)
- **update_gist** - Update Gist
- **Required OAuth Scopes**: `gist`
- `content`: Content for the file (string, required)
- `description`: Updated description of the gist (string, optional)
- `filename`: Filename to update or create (string, required)
- `gist_id`: ID of the gist to update (string, required)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/git-branch-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/git-branch-light.png"><img src="pkg/octicons/icons/git-branch-light.png" width="20" height="20" alt="git-branch"></picture> Git</summary>
- **get_repository_tree** - Get repository tree
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (username or organization) (string, required)
- `path_filter`: Optional path prefix to filter the tree results (e.g., 'src/' to only show files in the src directory) (string, optional)
- `recursive`: Setting this parameter to true returns the objects or subtrees referenced by the tree. Default is false (boolean, optional)
- `repo`: Repository name (string, required)
- `tree_sha`: The SHA1 value or ref (branch or tag) name of the tree. Defaults to the repository's default branch (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/issue-opened-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/issue-opened-light.png"><img src="pkg/octicons/icons/issue-opened-light.png" width="20" height="20" alt="issue-opened"></picture> Issues</summary>
- **add_issue_comment** - Add comment to issue
- **Required OAuth Scopes**: `repo`
- `body`: Comment content (string, required)
- `issue_number`: Issue number to comment on (number, required)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- **get_label** - Get a specific label from a repository.
- **Required OAuth Scopes**: `repo`
- `name`: Label name. (string, required)
- `owner`: Repository owner (username or organization name) (string, required)
- `repo`: Repository name (string, required)
- **issue_read** - Get issue details
- **Required OAuth Scopes**: `repo`
- `issue_number`: The number of the issue (number, required)
- `method`: The read operation to perform on a single issue.
Options are:
1. get - Get details of a specific issue.
2. get_comments - Get issue comments.
3. get_sub_issues - Get sub-issues of the issue.
4. get_labels - Get labels assigned to the issue.
(string, required)
- `owner`: The owner of the repository (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: The name of the repository (string, required)
- **issue_write** - Create or update issue.
- **Required OAuth Scopes**: `repo`
- `assignees`: Usernames to assign to this issue (string[], optional)
- `body`: Issue body content (string, optional)
- `duplicate_of`: Issue number that this issue is a duplicate of. Only used when state_reason is 'duplicate'. (number, optional)
- `issue_number`: Issue number to update (number, optional)
- `labels`: Labels to apply to this issue (string[], optional)
- `method`: Write operation to perform on a single issue.
Options are:
- 'create' - creates a new issue.
- 'update' - updates an existing issue.
(string, required)
- `milestone`: Milestone number (number, optional)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `state`: New state (string, optional)
- `state_reason`: Reason for the state change. Ignored unless state is changed. (string, optional)
- `title`: Issue title (string, optional)
- `type`: Type of this issue. Only use if the repository has issue types configured. Use list_issue_types tool to get valid type values for the organization. If the repository doesn't support issue types, omit this parameter. (string, optional)
- **list_issue_types** - List available issue types
- **Required OAuth Scopes**: `read:org`
- **Accepted OAuth Scopes**: `admin:org`, `read:org`, `write:org`
- `owner`: The organization owner of the repository (string, required)
- **list_issues** - List issues
- **Required OAuth Scopes**: `repo`
- `after`: Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. (string, optional)
- `direction`: Order direction. If provided, the 'orderBy' also needs to be provided. (string, optional)
- `labels`: Filter by labels (string[], optional)
- `orderBy`: Order issues by field. If provided, the 'direction' also needs to be provided. (string, optional)
- `owner`: Repository owner (string, required)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name (string, required)
- `since`: Filter by date (ISO 8601 timestamp) (string, optional)
- `state`: Filter by state, by default both open and closed issues are returned when not provided (string, optional)
- **search_issues** - Search issues
- **Required OAuth Scopes**: `repo`
- `order`: Sort order (string, optional)
- `owner`: Optional repository owner. If provided with repo, only issues for this repository are listed. (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `query`: Search query using GitHub issues search syntax (string, required)
- `repo`: Optional repository name. If provided with owner, only issues for this repository are listed. (string, optional)
- `sort`: Sort field by number of matches of categories, defaults to best match (string, optional)
- **sub_issue_write** - Change sub-issue
- **Required OAuth Scopes**: `repo`
- `after_id`: The ID of the sub-issue to be prioritized after (either after_id OR before_id should be specified) (number, optional)
- `before_id`: The ID of the sub-issue to be prioritized before (either after_id OR before_id should be specified) (number, optional)
- `issue_number`: The number of the parent issue (number, required)
- `method`: The action to perform on a single sub-issue
Options are:
- 'add' - add a sub-issue to a parent issue in a GitHub repository.
- 'remove' - remove a sub-issue from a parent issue in a GitHub repository.
- 'reprioritize' - change the order of sub-issues within a parent issue in a GitHub repository. Use either 'after_id' or 'before_id' to specify the new position.
(string, required)
- `owner`: Repository owner (string, required)
- `replace_parent`: When true, replaces the sub-issue's current parent issue. Use with 'add' method only. (boolean, optional)
- `repo`: Repository name (string, required)
- `sub_issue_id`: The ID of the sub-issue to add. ID is not the same as issue number (number, required)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/tag-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/tag-light.png"><img src="pkg/octicons/icons/tag-light.png" width="20" height="20" alt="tag"></picture> Labels</summary>
- **get_label** - Get a specific label from a repository.
- **Required OAuth Scopes**: `repo`
- `name`: Label name. (string, required)
- `owner`: Repository owner (username or organization name) (string, required)
- `repo`: Repository name (string, required)
- **label_write** - Write operations on repository labels.
- **Required OAuth Scopes**: `repo`
- `color`: Label color as 6-character hex code without '#' prefix (e.g., 'f29513'). Required for 'create', optional for 'update'. (string, optional)
- `description`: Label description text. Optional for 'create' and 'update'. (string, optional)
- `method`: Operation to perform: 'create', 'update', or 'delete' (string, required)
- `name`: Label name - required for all operations (string, required)
- `new_name`: New name for the label (used only with 'update' method to rename) (string, optional)
- `owner`: Repository owner (username or organization name) (string, required)
- `repo`: Repository name (string, required)
- **list_label** - List labels from a repository
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (username or organization name) - required for all operations (string, required)
- `repo`: Repository name - required for all operations (string, required)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/bell-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/bell-light.png"><img src="pkg/octicons/icons/bell-light.png" width="20" height="20" alt="bell"></picture> Notifications</summary>
- **dismiss_notification** - Dismiss notification
- **Required OAuth Scopes**: `notifications`
- `state`: The new state of the notification (read/done) (string, required)
- `threadID`: The ID of the notification thread (string, required)
- **get_notification_details** - Get notification details
- **Required OAuth Scopes**: `notifications`
- `notificationID`: The ID of the notification (string, required)
- **list_notifications** - List notifications
- **Required OAuth Scopes**: `notifications`
- `before`: Only show notifications updated before the given time (ISO 8601 format) (string, optional)
- `filter`: Filter notifications to, use default unless specified. Read notifications are ones that have already been acknowledged by the user. Participating notifications are those that the user is directly involved in, such as issues or pull requests they have commented on or created. (string, optional)
- `owner`: Optional repository owner. If provided with repo, only notifications for this repository are listed. (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Optional repository name. If provided with owner, only notifications for this repository are listed. (string, optional)
- `since`: Only show notifications updated after the given time (ISO 8601 format) (string, optional)
- **manage_notification_subscription** - Manage notification subscription
- **Required OAuth Scopes**: `notifications`
- `action`: Action to perform: ignore, watch, or delete the notification subscription. (string, required)
- `notificationID`: The ID of the notification thread. (string, required)
- **manage_repository_notification_subscription** - Manage repository notification subscription
- **Required OAuth Scopes**: `notifications`
- `action`: Action to perform: ignore, watch, or delete the repository notification subscription. (string, required)
- `owner`: The account owner of the repository. (string, required)
- `repo`: The name of the repository. (string, required)
- **mark_all_notifications_read** - Mark all notifications as read
- **Required OAuth Scopes**: `notifications`
- `lastReadAt`: Describes the last point that notifications were checked (optional). Default: Now (string, optional)
- `owner`: Optional repository owner. If provided with repo, only notifications for this repository are marked as read. (string, optional)
- `repo`: Optional repository name. If provided with owner, only notifications for this repository are marked as read. (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/organization-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/organization-light.png"><img src="pkg/octicons/icons/organization-light.png" width="20" height="20" alt="organization"></picture> Organizations</summary>
- **search_orgs** - Search organizations
- **Required OAuth Scopes**: `read:org`
- **Accepted OAuth Scopes**: `admin:org`, `read:org`, `write:org`
- `order`: Sort order (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `query`: Organization search query. Examples: 'microsoft', 'location:california', 'created:>=2025-01-01'. Search is automatically scoped to type:org. (string, required)
- `sort`: Sort field by category (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/project-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/project-light.png"><img src="pkg/octicons/icons/project-light.png" width="20" height="20" alt="project"></picture> Projects</summary>
- **projects_get** - Get details of GitHub Projects resources
- **Required OAuth Scopes**: `read:project`
- **Accepted OAuth Scopes**: `project`, `read:project`
- `field_id`: The field's ID. Required for 'get_project_field' method. (number, optional)
- `fields`: Specific list of field IDs to include in the response when getting a project item (e.g. ["102589", "985201", "169875"]). If not provided, only the title field is included. Only used for 'get_project_item' method. (string[], optional)
- `item_id`: The item's ID. Required for 'get_project_item' method. (number, optional)
- `method`: The method to execute (string, required)
- `owner`: The owner (user or organization login). The name is not case sensitive. (string, optional)
- `owner_type`: Owner type (user or org). If not provided, will be automatically detected. (string, optional)
- `project_number`: The project's number. (number, optional)
- `status_update_id`: The node ID of the project status update. Required for 'get_project_status_update' method. (string, optional)
- **projects_list** - List GitHub Projects resources
- **Required OAuth Scopes**: `read:project`
- **Accepted OAuth Scopes**: `project`, `read:project`
- `after`: Forward pagination cursor from previous pageInfo.nextCursor. (string, optional)
- `before`: Backward pagination cursor from previous pageInfo.prevCursor (rare). (string, optional)
- `fields`: Field IDs to include when listing project items (e.g. ["102589", "985201"]). CRITICAL: Always provide to get field values. Without this, only titles returned. Only used for 'list_project_items' method. (string[], optional)
- `method`: The action to perform (string, required)
- `owner`: The owner (user or organization login). The name is not case sensitive. (string, required)
- `owner_type`: Owner type (user or org). If not provided, will automatically try both. (string, optional)
- `per_page`: Results per page (max 50) (number, optional)
- `project_number`: The project's number. Required for 'list_project_fields', 'list_project_items', and 'list_project_status_updates' methods. (number, optional)
- `query`: Filter/query string. For list_projects: filter by title text and state (e.g. "roadmap is:open"). For list_project_items: advanced filtering using GitHub's project filtering syntax. (string, optional)
- **projects_write** - Modify GitHub Project items
- **Required OAuth Scopes**: `project`
- `body`: The body of the status update (markdown). Used for 'create_project_status_update' method. (string, optional)
- `issue_number`: The issue number (use when item_type is 'issue' for 'add_project_item' method). Provide either issue_number or pull_request_number. (number, optional)
- `item_id`: The project item ID. Required for 'update_project_item' and 'delete_project_item' methods. (number, optional)
- `item_owner`: The owner (user or organization) of the repository containing the issue or pull request. Required for 'add_project_item' method. (string, optional)
- `item_repo`: The name of the repository containing the issue or pull request. Required for 'add_project_item' method. (string, optional)
- `item_type`: The item's type, either issue or pull_request. Required for 'add_project_item' method. (string, optional)
- `method`: The method to execute (string, required)
- `owner`: The project owner (user or organization login). The name is not case sensitive. (string, required)
- `owner_type`: Owner type (user or org). If not provided, will be automatically detected. (string, optional)
- `project_number`: The project's number. (number, required)
- `pull_request_number`: The pull request number (use when item_type is 'pull_request' for 'add_project_item' method). Provide either issue_number or pull_request_number. (number, optional)
- `start_date`: The start date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method. (string, optional)
- `status`: The status of the project. Used for 'create_project_status_update' method. (string, optional)
- `target_date`: The target date of the status update in YYYY-MM-DD format. Used for 'create_project_status_update' method. (string, optional)
- `updated_field`: Object consisting of the ID of the project field to update and the new value for the field. To clear the field, set value to null. Example: {"id": 123456, "value": "New Value"}. Required for 'update_project_item' method. (object, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/git-pull-request-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/git-pull-request-light.png"><img src="pkg/octicons/icons/git-pull-request-light.png" width="20" height="20" alt="git-pull-request"></picture> Pull Requests</summary>
- **add_comment_to_pending_review** - Add review comment to the requester's latest pending pull request review
- **Required OAuth Scopes**: `repo`
- `body`: The text of the review comment (string, required)
- `line`: The line of the blob in the pull request diff that the comment applies to. For multi-line comments, the last line of the range (number, optional)
- `owner`: Repository owner (string, required)
- `path`: The relative path to the file that necessitates a comment (string, required)
- `pullNumber`: Pull request number (number, required)
- `repo`: Repository name (string, required)
- `side`: The side of the diff to comment on. LEFT indicates the previous state, RIGHT indicates the new state (string, optional)
- `startLine`: For multi-line comments, the first line of the range that the comment applies to (number, optional)
- `startSide`: For multi-line comments, the starting side of the diff that the comment applies to. LEFT indicates the previous state, RIGHT indicates the new state (string, optional)
- `subjectType`: The level at which the comment is targeted (string, required)
- **add_reply_to_pull_request_comment** - Add reply to pull request comment
- **Required OAuth Scopes**: `repo`
- `body`: The text of the reply (string, required)
- `commentId`: The ID of the comment to reply to (number, required)
- `owner`: Repository owner (string, required)
- `pullNumber`: Pull request number (number, required)
- `repo`: Repository name (string, required)
- **create_pull_request** - Open new pull request
- **Required OAuth Scopes**: `repo`
- `base`: Branch to merge into (string, required)
- `body`: PR description (string, optional)
- `draft`: Create as draft PR (boolean, optional)
- `head`: Branch containing changes (string, required)
- `maintainer_can_modify`: Allow maintainer edits (boolean, optional)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `title`: PR title (string, required)
- **list_pull_requests** - List pull requests
- **Required OAuth Scopes**: `repo`
- `base`: Filter by base branch (string, optional)
- `direction`: Sort direction (string, optional)
- `head`: Filter by head user/org and branch (string, optional)
- `owner`: Repository owner (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name (string, required)
- `sort`: Sort by (string, optional)
- `state`: Filter by state (string, optional)
- **merge_pull_request** - Merge pull request
- **Required OAuth Scopes**: `repo`
- `commit_message`: Extra detail for merge commit (string, optional)
- `commit_title`: Title for merge commit (string, optional)
- `merge_method`: Merge method (string, optional)
- `owner`: Repository owner (string, required)
- `pullNumber`: Pull request number (number, required)
- `repo`: Repository name (string, required)
- **pull_request_read** - Get details for a single pull request
- **Required OAuth Scopes**: `repo`
- `method`: Action to specify what pull request data needs to be retrieved from GitHub.
Possible options:
1. get - Get details of a specific pull request.
2. get_diff - Get the diff of a pull request.
3. get_status - Get combined commit status of a head commit in a pull request.
4. get_files - Get the list of files changed in a pull request. Use with pagination parameters to control the number of results returned.
5. get_review_comments - Get review threads on a pull request. Each thread contains logically grouped review comments made on the same code location during pull request reviews. Returns threads with metadata (isResolved, isOutdated, isCollapsed) and their associated comments. Use cursor-based pagination (perPage, after) to control results.
6. get_reviews - Get the reviews on a pull request. When asked for review comments, use get_review_comments method.
7. get_comments - Get comments on a pull request. Use this if user doesn't specifically want review comments. Use with pagination parameters to control the number of results returned.
8. get_check_runs - Get check runs for the head commit of a pull request. Check runs are the individual CI/CD jobs and checks that run on the PR.
(string, required)
- `owner`: Repository owner (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `pullNumber`: Pull request number (number, required)
- `repo`: Repository name (string, required)
- **pull_request_review_write** - Write operations (create, submit, delete) on pull request reviews.
- **Required OAuth Scopes**: `repo`
- `body`: Review comment text (string, optional)
- `commitID`: SHA of commit to review (string, optional)
- `event`: Review action to perform. (string, optional)
- `method`: The write operation to perform on pull request review. (string, required)
- `owner`: Repository owner (string, required)
- `pullNumber`: Pull request number (number, required)
- `repo`: Repository name (string, required)
- `threadId`: The node ID of the review thread (e.g., PRRT_kwDOxxx). Required for resolve_thread and unresolve_thread methods. Get thread IDs from pull_request_read with method get_review_comments. (string, optional)
- **search_pull_requests** - Search pull requests
- **Required OAuth Scopes**: `repo`
- `order`: Sort order (string, optional)
- `owner`: Optional repository owner. If provided with repo, only pull requests for this repository are listed. (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `query`: Search query using GitHub pull request search syntax (string, required)
- `repo`: Optional repository name. If provided with owner, only pull requests for this repository are listed. (string, optional)
- `sort`: Sort field by number of matches of categories, defaults to best match (string, optional)
- **update_pull_request** - Edit pull request
- **Required OAuth Scopes**: `repo`
- `base`: New base branch name (string, optional)
- `body`: New description (string, optional)
- `draft`: Mark pull request as draft (true) or ready for review (false) (boolean, optional)
- `maintainer_can_modify`: Allow maintainer edits (boolean, optional)
- `owner`: Repository owner (string, required)
- `pullNumber`: Pull request number to update (number, required)
- `repo`: Repository name (string, required)
- `reviewers`: GitHub usernames to request reviews from (string[], optional)
- `state`: New state (string, optional)
- `title`: New title (string, optional)
- **update_pull_request_branch** - Update pull request branch
- **Required OAuth Scopes**: `repo`
- `expectedHeadSha`: The expected SHA of the pull request's HEAD ref (string, optional)
- `owner`: Repository owner (string, required)
- `pullNumber`: Pull request number (number, required)
- `repo`: Repository name (string, required)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/repo-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/repo-light.png"><img src="pkg/octicons/icons/repo-light.png" width="20" height="20" alt="repo"></picture> Repositories</summary>
- **create_branch** - Create branch
- **Required OAuth Scopes**: `repo`
- `branch`: Name for new branch (string, required)
- `from_branch`: Source branch (defaults to repo default) (string, optional)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- **create_or_update_file** - Create or update file
- **Required OAuth Scopes**: `repo`
- `branch`: Branch to create/update the file in (string, required)
- `content`: Content of the file (string, required)
- `message`: Commit message (string, required)
- `owner`: Repository owner (username or organization) (string, required)
- `path`: Path where to create/update the file (string, required)
- `repo`: Repository name (string, required)
- `sha`: The blob SHA of the file being replaced. Required if the file already exists. (string, optional)
- **create_repository** - Create repository
- **Required OAuth Scopes**: `repo`
- `autoInit`: Initialize with README (boolean, optional)
- `description`: Repository description (string, optional)
- `name`: Repository name (string, required)
- `organization`: Organization to create the repository in (omit to create in your personal account) (string, optional)
- `private`: Whether repo should be private (boolean, optional)
- **delete_file** - Delete file
- **Required OAuth Scopes**: `repo`
- `branch`: Branch to delete the file from (string, required)
- `message`: Commit message (string, required)
- `owner`: Repository owner (username or organization) (string, required)
- `path`: Path to the file to delete (string, required)
- `repo`: Repository name (string, required)
- **fork_repository** - Fork repository
- **Required OAuth Scopes**: `repo`
- `organization`: Organization to fork to (string, optional)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- **get_commit** - Get commit details
- **Required OAuth Scopes**: `repo`
- `include_diff`: Whether to include file diffs and stats in the response. Default is true. (boolean, optional)
- `owner`: Repository owner (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name (string, required)
- `sha`: Commit SHA, branch name, or tag name (string, required)
- **get_file_contents** - Get file or directory contents
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (username or organization) (string, required)
- `path`: Path to file/directory (string, optional)
- `ref`: Accepts optional git refs such as `refs/tags/{tag}`, `refs/heads/{branch}` or `refs/pull/{pr_number}/head` (string, optional)
- `repo`: Repository name (string, required)
- `sha`: Accepts optional commit SHA. If specified, it will be used instead of ref (string, optional)
- **get_latest_release** - Get latest release
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- **get_release_by_tag** - Get a release by tag name
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `tag`: Tag name (e.g., 'v1.0.0') (string, required)
- **get_tag** - Get tag details
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- `tag`: Tag name (string, required)
- **list_branches** - List branches
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name (string, required)
- **list_commits** - List commits
- **Required OAuth Scopes**: `repo`
- `author`: Author username or email address to filter commits by (string, optional)
- `owner`: Repository owner (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name (string, required)
- `sha`: Commit SHA, branch or tag name to list commits of. If not provided, uses the default branch of the repository. If a commit SHA is provided, will list commits up to that SHA. (string, optional)
- **list_releases** - List releases
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name (string, required)
- **list_tags** - List tags
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `repo`: Repository name (string, required)
- **push_files** - Push files to repository
- **Required OAuth Scopes**: `repo`
- `branch`: Branch to push to (string, required)
- `files`: Array of file objects to push, each object with path (string) and content (string) (object[], required)
- `message`: Commit message (string, required)
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- **search_code** - Search code
- **Required OAuth Scopes**: `repo`
- `order`: Sort order for results (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `query`: Search query using GitHub's powerful code search syntax. Examples: 'content:Skill language:Java org:github', 'NOT is:archived language:Python OR language:go', 'repo:github/github-mcp-server'. Supports exact matching, language filters, path filters, and more. (string, required)
- `sort`: Sort field ('indexed' only) (string, optional)
- **search_repositories** - Search repositories
- **Required OAuth Scopes**: `repo`
- `minimal_output`: Return minimal repository information (default: true). When false, returns full GitHub API repository objects. (boolean, optional)
- `order`: Sort order (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `query`: Repository search query. Examples: 'machine learning in:name stars:>1000 language:python', 'topic:react', 'user:facebook'. Supports advanced search syntax for precise filtering. (string, required)
- `sort`: Sort repositories by field, defaults to best match (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/shield-lock-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/shield-lock-light.png"><img src="pkg/octicons/icons/shield-lock-light.png" width="20" height="20" alt="shield-lock"></picture> Secret Protection</summary>
- **get_secret_scanning_alert** - Get secret scanning alert
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `alertNumber`: The number of the alert. (number, required)
- `owner`: The owner of the repository. (string, required)
- `repo`: The name of the repository. (string, required)
- **list_secret_scanning_alerts** - List secret scanning alerts
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `owner`: The owner of the repository. (string, required)
- `repo`: The name of the repository. (string, required)
- `resolution`: Filter by resolution (string, optional)
- `secret_type`: A comma-separated list of secret types to return. All default secret patterns are returned. To return generic patterns, pass the token name(s) in the parameter. (string, optional)
- `state`: Filter by state (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/shield-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/shield-light.png"><img src="pkg/octicons/icons/shield-light.png" width="20" height="20" alt="shield"></picture> Security Advisories</summary>
- **get_global_security_advisory** - Get a global security advisory
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `ghsaId`: GitHub Security Advisory ID (format: GHSA-xxxx-xxxx-xxxx). (string, required)
- **list_global_security_advisories** - List global security advisories
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `affects`: Filter advisories by affected package or version (e.g. "package1,package2@1.0.0"). (string, optional)
- `cveId`: Filter by CVE ID. (string, optional)
- `cwes`: Filter by Common Weakness Enumeration IDs (e.g. ["79", "284", "22"]). (string[], optional)
- `ecosystem`: Filter by package ecosystem. (string, optional)
- `ghsaId`: Filter by GitHub Security Advisory ID (format: GHSA-xxxx-xxxx-xxxx). (string, optional)
- `isWithdrawn`: Whether to only return withdrawn advisories. (boolean, optional)
- `modified`: Filter by publish or update date or date range (ISO 8601 date or range). (string, optional)
- `published`: Filter by publish date or date range (ISO 8601 date or range). (string, optional)
- `severity`: Filter by severity. (string, optional)
- `type`: Advisory type. (string, optional)
- `updated`: Filter by update date or date range (ISO 8601 date or range). (string, optional)
- **list_org_repository_security_advisories** - List org repository security advisories
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `direction`: Sort direction. (string, optional)
- `org`: The organization login. (string, required)
- `sort`: Sort field. (string, optional)
- `state`: Filter by advisory state. (string, optional)
- **list_repository_security_advisories** - List repository security advisories
- **Required OAuth Scopes**: `security_events`
- **Accepted OAuth Scopes**: `repo`, `security_events`
- `direction`: Sort direction. (string, optional)
- `owner`: The owner of the repository. (string, required)
- `repo`: The name of the repository. (string, required)
- `sort`: Sort field. (string, optional)
- `state`: Filter by advisory state. (string, optional)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/star-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/star-light.png"><img src="pkg/octicons/icons/star-light.png" width="20" height="20" alt="star"></picture> Stargazers</summary>
- **list_starred_repositories** - List starred repositories
- **Required OAuth Scopes**: `repo`
- `direction`: The direction to sort the results by. (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `sort`: How to sort the results. Can be either 'created' (when the repository was starred) or 'updated' (when the repository was last pushed to). (string, optional)
- `username`: Username to list starred repositories for. Defaults to the authenticated user. (string, optional)
- **star_repository** - Star repository
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
- **unstar_repository** - Unstar repository
- **Required OAuth Scopes**: `repo`
- `owner`: Repository owner (string, required)
- `repo`: Repository name (string, required)
</details>
<details>
<summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/people-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/people-light.png"><img src="pkg/octicons/icons/people-light.png" width="20" height="20" alt="people"></picture> Users</summary>
- **search_users** - Search users
- **Required OAuth Scopes**: `repo`
- `order`: Sort order (string, optional)
- `page`: Page number for pagination (min 1) (number, optional)
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
- `query`: User search query. Examples: 'john smith', 'location:seattle', 'followers:>100'. Search is automatically scoped to type:user. (string, required)
- `sort`: Sort users by number of followers or repositories, or when the person joined GitHub. (string, optional)
</details>
<!-- END AUTOMATED TOOLS -->
### Additional Tools in Remote GitHub MCP Server
<details>
<summary>Copilot</summary>
- **create_pull_request_with_copilot** - Perform task with GitHub Copilot coding agent
- `owner`: Repository owner. You can guess the owner, but confirm it with the user before proceeding. (string, required)
- `repo`: Repository name. You can guess the repository name, but confirm it with the user before proceeding. (string, required)
- `problem_statement`: Detailed description of the task to be performed (e.g., 'Implement a feature that does X', 'Fix bug Y', etc.) (string, required)
- `title`: Title for the pull request that will be created (string, required)
- `base_ref`: Git reference (e.g., branch) that the agent will start its work from. If not specified, defaults to the repository's default branch (string, optional)
</details>
<details>
<summary>Copilot Spaces</summary>
- **get_copilot_space** - Get Copilot Space
- `owner`: The owner of the space. (string, required)
- `name`: The name of the space. (string, required)
- **list_copilot_spaces** - List Copilot Spaces
</details>
<details>
<summary>GitHub Support Docs Search</summary>
- **github_support_docs_search** - Retrieve documentation relevant to answer GitHub product and support questions. Support topics include: GitHub Actions Workflows, Authentication, GitHub Support Inquiries, Pull Request Practices, Repository Maintenance, GitHub Pages, GitHub Packages, GitHub Discussions, Copilot Spaces
- `query`: Input from the user about the question they need answered. This is the latest raw unedited user message. You should ALWAYS leave the user message as it is, you should never modify it. (string, required)
</details>
## Dynamic Tool Discovery
**Note**: This feature is currently in beta and is not available in the Remote GitHub MCP Server. Please test it out and let us know if you encounter any issues.
Instead of starting with all tools enabled, you can turn on dynamic toolset discovery. Dynamic toolsets allow the MCP host to list and enable toolsets in response to a user prompt. This should help to avoid situations where the model gets confused by the sheer number of tools available.
### Using Dynamic Tool Discovery
When using the binary, you can pass the `--dynamic-toolsets` flag.
```bash
./github-mcp-server --dynamic-toolsets
```
When using Docker, you can pass the toolsets as environment variables:
```bash
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
-e GITHUB_DYNAMIC_TOOLSETS=1 \
ghcr.io/github/github-mcp-server
```
## Read-Only Mode
To run the server in read-only mode, you can use the `--read-only` flag. This will only offer read-only tools, preventing any modifications to repositories, issues, pull requests, etc.
```bash
./github-mcp-server --read-only
```
When using Docker, you can pass the read-only mode as an environment variable:
```bash
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
-e GITHUB_READ_ONLY=1 \
ghcr.io/github/github-mcp-server
```
## Lockdown Mode
Lockdown mode limits the content that the server will surface from public repositories. When enabled, the server checks whether the author of each item has push access to the repository. Private repositories are unaffected, and collaborators keep full access to their own content.
```bash
./github-mcp-server --lockdown-mode
```
When running with Docker, set the corresponding environment variable:
```bash
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
-e GITHUB_LOCKDOWN_MODE=1 \
ghcr.io/github/github-mcp-server
```
The behavior of lockdown mode depends on the tool invoked.
Following tools will return an error when the author lacks the push access:
- `issue_read:get`
- `pull_request_read:get`
Following tools will filter out content from users lacking the push access:
- `issue_read:get_comments`
- `issue_read:get_sub_issues`
- `pull_request_read:get_comments`
- `pull_request_read:get_review_comments`
- `pull_request_read:get_reviews`
## i18n / Overriding Descriptions
The descriptions of the tools can be overridden by creating a
`github-mcp-server-config.json` file in the same directory as the binary.
The file should contain a JSON object with the tool names as keys and the new
descriptions as values. For example:
```json
{
"TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "an alternative description",
"TOOL_CREATE_BRANCH_DESCRIPTION": "Create a new branch in a GitHub repository"
}
```
You can create an export of the current translations by running the binary with
the `--export-translations` flag.
This flag will preserve any translations/overrides you have made, while adding
any new translations that have been added to the binary since the last time you
exported.
```sh
./github-mcp-server --export-translations
cat github-mcp-server-config.json
```
You can also use ENV vars to override the descriptions. The environment
variable names are the same as the keys in the JSON file, prefixed with
`GITHUB_MCP_` and all uppercase.
For example, to override the `TOOL_ADD_ISSUE_COMMENT_DESCRIPTION` tool, you can
set the following environment variable:
```sh
export GITHUB_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION="an alternative description"
```
### Overriding Server Name and Title
The same override mechanism can be used to customize the MCP server's `name` and
`title` fields in the initialization response. This is useful when running
multiple GitHub MCP Server instances (e.g., one for github.com and one for
GitHub Enterprise Server) so that agents can distinguish between them.
| Key | Environment Variable | Default |
|-----|---------------------|---------|
| `SERVER_NAME` | `GITHUB_MCP_SERVER_NAME` | `github-mcp-server` |
| `SERVER_TITLE` | `GITHUB_MCP_SERVER_TITLE` | `GitHub MCP Server` |
For example, to configure a server instance for GitHub Enterprise Server:
```json
{
"SERVER_NAME": "ghes-mcp-server",
"SERVER_TITLE": "GHES MCP Server"
}
```
Or using environment variables:
```sh
export GITHUB_MCP_SERVER_NAME="ghes-mcp-server"
export GITHUB_MCP_SERVER_TITLE="GHES MCP Server"
```
## Library Usage
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.
## License
This project is licensed under the terms of the MIT open source license. Please refer to [MIT](./LICENSE) for the full terms.
================================================
FILE: SECURITY.md
================================================
Thanks for helping make GitHub safe for everyone.
# Security
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.
## Reporting Security Issues
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.
## Policy
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)
================================================
FILE: SUPPORT.md
================================================
# Support
## How to file issues and get help
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.
## GitHub Support Policy
Support for this project is limited to the resources listed above.
================================================
FILE: docs/error-handling.md
================================================
# Error Handling
This document describes the error handling patterns used in the GitHub MCP Server, specifically how we handle GitHub API errors and avoid direct use of mcp-go error types.
## Overview
The GitHub MCP Server implements a custom error handling approach that serves two primary purposes:
1. **Tool Response Generation**: Return appropriate MCP tool error responses to clients
2. **Middleware Inspection**: Store detailed error information in the request context for middleware analysis
This dual approach enables better observability and debugging capabilities, particularly for remote server deployments where understanding the nature of failures (rate limiting, authentication, 404s, 500s, etc.) is crucial for validation and monitoring.
## Error Types
### GitHubAPIError
Used for REST API errors from the GitHub API:
```go
type GitHubAPIError struct {
Message string `json:"message"`
Response *github.Response `json:"-"`
Err error `json:"-"`
}
```
### GitHubGraphQLError
Used for GraphQL API errors from the GitHub API:
```go
type GitHubGraphQLError struct {
Message string `json:"message"`
Err error `json:"-"`
}
```
## Usage Patterns
### For GitHub REST API Errors
Instead of directly returning `mcp.NewToolResultError()`, use:
```go
return ghErrors.NewGitHubAPIErrorResponse(ctx, message, response, err), nil
```
This function:
- Creates a `GitHubAPIError` with the provided message, response, and error
- Stores the error in the context for middleware inspection
- Returns an appropriate MCP tool error response
### For GitHub GraphQL API Errors
```go
return ghErrors.NewGitHubGraphQLErrorResponse(ctx, message, err), nil
```
### Context Management
The error handling system uses context to store errors for later inspection:
```go
// Initialize context with error tracking
ctx = errors.ContextWithGitHubErrors(ctx)
// Retrieve errors for inspection (typically in middleware)
apiErrors, err := errors.GetGitHubAPIErrors(ctx)
graphqlErrors, err := errors.GetGitHubGraphQLErrors(ctx)
```
## Design Principles
### User-Actionable vs. Developer Errors
- **User-actionable errors** (authentication failures, rate limits, 404s) should be returned as failed tool calls using the error response functions
- **Developer errors** (JSON marshaling failures, internal logic errors) should be returned as actual Go errors that bubble up through the MCP framework
### Context Limitations
This approach was designed to work around current limitations in mcp-go where context is not propagated through each step of request processing. By storing errors in context values, middleware can inspect them without requiring context propagation.
### Graceful Error Handling
Error storage operations in context are designed to fail gracefully - if context storage fails, the tool will still return an appropriate error response to the client.
## Benefits
1. **Observability**: Middleware can inspect the specific types of GitHub API errors occurring
2. **Debugging**: Detailed error information is preserved without exposing potentially sensitive data in logs
3. **Validation**: Remote servers can use error types and HTTP status codes to validate that changes don't break functionality
4. **Privacy**: Error inspection can be done programmatically using `errors.Is` checks without logging PII
## Example Implementation
```go
func GetIssue(getClient GetClientFn, t translations.TranslationHelperFunc) (tool mcp.Tool, handler server.ToolHandlerFunc) {
return mcp.NewTool("get_issue", /* ... */),
func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
owner, err := RequiredParam[string](request, "owner")
if err != nil {
return mcp.NewToolResultError(err.Error()), nil
}
client, err := getClient(ctx)
if err != nil {
return nil, fmt.Errorf("failed to get GitHub client: %w", err)
}
issue, resp, err := client.Issues.Get(ctx, owner, repo, issueNumber)
if err != nil {
return ghErrors.NewGitHubAPIErrorResponse(ctx,
"failed to get issue",
resp,
err,
), nil
}
return MarshalledTextResult(issue), nil
}
}
```
This approach ensures that both the client receives an appropriate error response and any middleware can inspect the underlying GitHub API error for monitoring and debugging purposes.
================================================
FILE: docs/host-integration.md
================================================
# GitHub Remote MCP Integration Guide for MCP Host Authors
This guide outlines high-level considerations for MCP Host authors who want to allow installation of the Remote GitHub MCP server.
The goal is to explain the architecture at a high-level, define key requirements, and provide guidance to get you started, while pointing to official documentation for deeper implementation details.
---
## Table of Contents
- [Understanding MCP Architecture](#understanding-mcp-architecture)
- [Connecting to the Remote GitHub MCP Server](#connecting-to-the-remote-github-mcp-server)
- [Authentication and Authorization](#authentication-and-authorization)
- [OAuth Support on GitHub](#oauth-support-on-github)
- [Create an OAuth-enabled App Using the GitHub UI](#create-an-oauth-enabled-app-using-the-github-ui)
- [Things to Consider](#things-to-consider)
- [Initiating the OAuth Flow from your Client Application](#initiating-the-oauth-flow-from-your-client-application)
- [Handling Organization Access Restrictions](#handling-organization-access-restrictions)
- [Essential Security Considerations](#essential-security-considerations)
- [Additional Resources](#additional-resources)
---
## Understanding MCP Architecture
The Model Context Protocol (MCP) enables seamless communication between your application and various external tools through an architecture defined by the [MCP Standard](https://modelcontextprotocol.io/).
### High-level Architecture
The diagram below illustrates how a single client application can connect to multiple MCP Servers, each providing access to a unique set of resources. Notice that some MCP Servers are running locally (side-by-side with the client application) while others are hosted remotely. GitHub's MCP offerings are available to run either locally or remotely.
```mermaid
flowchart LR
subgraph "Local Runtime Environment"
subgraph "Client Application (e.g., IDE)"
CLIENTAPP[Application Runtime]
CX["MCP Client (FileSystem)"]
CY["MCP Client (GitHub)"]
CZ["MCP Client (Other)"]
end
LOCALMCP[File System MCP Server]
end
subgraph "Internet"
GITHUBMCP[GitHub Remote MCP Server]
OTHERMCP[Other Remote MCP Server]
end
CLIENTAPP --> CX
CLIENTAPP --> CY
CLIENTAPP --> CZ
CX <-->|"stdio"| LOCALMCP
CY <-->|"OAuth 2.0 + HTTP/SSE"| GITHUBMCP
CZ <-->|"OAuth 2.0 + HTTP/SSE"| OTHERMCP
```
### Runtime Environment
- **Application**: The user-facing application you are building. It instantiates one or more MCP clients and orchestrates tool calls.
- **MCP Client**: A component within your client application that maintains a 1:1 connection with a single MCP server.
- **MCP Server**: A service that provides access to a specific set of tools.
- **Local MCP Server**: An MCP Server running locally, side-by-side with the Application.
- **Remote MCP Server**: An MCP Server running remotely, accessed via the internet. Most Remote MCP Servers require authentication via OAuth.
For more detail, see the [official MCP specification](https://modelcontextprotocol.io/specification/2025-06-18).
> [!NOTE]
> GitHub offers both a Local MCP Server and a Remote MCP Server.
---
## Connecting to the Remote GitHub MCP Server
### Authentication and Authorization
GitHub MCP Servers require a valid access token in the `Authorization` header. This is true for both the Local GitHub MCP Server and the Remote GitHub MCP Server.
For the Remote GitHub MCP Server, the recommended way to obtain a valid access token is to ensure your client application supports [OAuth 2.1](https://datatracker.ietf.org/doc/html/draft-ietf-oauth-v2-1-13). It should be noted, however, that you may also supply any valid access token. For example, you may supply a pre-generated Personal Access Token (PAT).
> [!IMPORTANT]
> The Remote GitHub MCP Server itself does not provide Authentication services.
> Your client application must obtain valid GitHub access tokens through one of the supported methods.
The expected flow for obtaining a valid access token via OAuth is depicted in the [MCP Specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization#authorization-flow-steps). For convenience, we've embedded a copy of the authorization flow below. Please study it carefully as the remainder of this document is written with this flow in mind.
```mermaid
sequenceDiagram
participant B as User-Agent (Browser)
participant C as Client
participant M as MCP Server (Resource Server)
participant A as Authorization Server
C->>M: MCP request without token
M->>C: HTTP 401 Unauthorized with WWW-Authenticate header
Note over C: Extract resource_metadata URL from WWW-Authenticate
C->>M: Request Protected Resource Metadata
M->>C: Return metadata
Note over C: Parse metadata and extract authorization server(s)<br/>Client determines AS to use
C->>A: GET /.well-known/oauth-authorization-server
A->>C: Authorization server metadata response
alt Dynamic client registration
C->>A: POST /register
A->>C: Client Credentials
end
Note over C: Generate PKCE parameters
C->>B: Open browser with authorization URL + code_challenge
B->>A: Authorization request
Note over A: User authorizes
A->>B: Redirect to callback with authorization code
B->>C: Authorization code callback
C->>A: Token request + code_verifier
A->>C: Access token (+ refresh token)
C->>M: MCP request with access token
M-->>C: MCP response
Note over C,M: MCP communication continues with valid token
```
> [!NOTE]
> Dynamic Client Registration is NOT supported by Remote GitHub MCP Server at this time.
#### OAuth Support on GitHub
GitHub offers two solutions for obtaining access tokens via OAuth: [**GitHub Apps**](https://docs.github.com/en/apps/using-github-apps/about-using-github-apps#about-github-apps) and [**OAuth Apps**](https://docs.github.com/en/apps/oauth-apps). These solutions are typically created, administered, and maintained by GitHub Organization administrators. Collaborate with a GitHub Organization administrator to configure either a **GitHub App** or an **OAuth App** to allow your client application to utilize GitHub OAuth support. Furthermore, be aware that it may be necessary for users of your client application to register your **GitHub App** or **OAuth App** within their own GitHub Organization in order to generate authorization tokens capable of accessing Organization's GitHub resources.
> [!TIP]
> Before proceeding, check whether your organization already supports one of these solutions. Administrators of your GitHub Organization can help you determine what **GitHub Apps** or **OAuth Apps** are already registered. If there's an existing **GitHub App** or **OAuth App** that fits your use case, consider reusing it for Remote MCP Authorization. That said, be sure to take heed of the following warning.
> [!WARNING]
> Both **GitHub Apps** and **OAuth Apps** require the client application to pass a "client secret" in order to initiate the OAuth flow. If your client application is designed to run in an uncontrolled environment (i.e. customer-provided hardware), end users will be able to discover your "client secret" and potentially exploit it for other purposes. In such cases, our recommendation is to register a new **GitHub App** (or **OAuth App**) exclusively dedicated to servicing OAuth requests from your client application.
#### Create an OAuth-enabled App Using the GitHub UI
Detailed instructions for creating a **GitHub App** can be found at ["Creating GitHub Apps"](https://docs.github.com/en/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps#building-a-github-app). (RECOMMENDED)<br/>
Detailed instructions for creating an **OAuth App** can be found ["Creating an OAuth App"](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app).
For guidance on which type of app to choose, see ["Differences Between GitHub Apps and OAuth Apps"](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps).
#### Things to Consider:
- Tokens provided by **GitHub Apps** are generally more secure because they:
- include an expiration
- include support for fine-grained permissions
- **GitHub Apps** must be installed on a GitHub Organization before they can be used.<br/>In general, installation must be approved by someone in the Organization with administrator permissions. For more details, see [this explanation](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps#who-can-install-github-apps-and-authorize-oauth-apps).<br/>By contrast, **OAuth Apps** don't require installation and, typically, can be used immediately.
- Members of an Organization may use the GitHub UI to [request that a GitHub App be installed](https://docs.github.com/en/apps/using-github-apps/requesting-a-github-app-from-your-organization-owner) organization-wide.
- While not strictly necessary, if you expect that a wide range of users will use your MCP Server, consider publishing its corresponding **GitHub App** or **OAuth App** on the [GitHub App Marketplace](https://github.com/marketplace?type=apps) to ensure that it's discoverable by your audience.
#### Initiating the OAuth Flow from your Client Application
For **GitHub Apps**, details on initiating the OAuth flow from a client application are described in detail [here](https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app#using-the-web-application-flow-to-generate-a-user-access-token).
For **OAuth Apps**, details on initiating the OAuth flow from a client application are described in detail [here](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps#web-application-flow).
> [!IMPORTANT]
> For endpoint discovery, be sure to honor the [`WWW-Authenticate` information provided](https://modelcontextprotocol.io/specification/draft/basic/authorization#authorization-server-location) by the Remote GitHub MCP Server rather than relying on hard-coded endpoints like `https://github.com/login/oauth/authorize`.
### Handling Organization Access Restrictions
Organizations may block **GitHub Apps** and **OAuth Apps** until explicitly approved. Within your client application code, you can provide actionable next steps for a smooth user experience in the event that OAuth-related calls fail due to your **GitHub App** or **OAuth App** being unavailable (i.e. not registered within the user's organization).
1. Detect the specific error.
2. Notify the user clearly.
3. Depending on their GitHub organization privileges:
- Org Members: Prompt them to request approval from a GitHub organization admin, within the organization where access has not been approved.
- Org Admins: Link them to the corresponding GitHub organization’s App approval settings at `https://github.com/organizations/[ORG_NAME]/settings/oauth_application_policy`
## Essential Security Considerations
- **Token Storage**: Use secure platform APIs (e.g. keytar for Node.js).
- **Input Validation**: Sanitize all tool arguments.
- **HTTPS Only**: Never send requests over plaintext HTTP. Always use HTTPS in production.
- **PKCE:** We strongly recommend implementing [PKCE](https://datatracker.ietf.org/doc/html/rfc7636) for all OAuth flows to prevent code interception, to prepare for upcoming PKCE support.
## Additional Resources
- [MCP Official Spec](https://modelcontextprotocol.io/specification/draft)
- [MCP SDKs](https://modelcontextprotocol.io/sdk/java/mcp-overview)
- [GitHub Docs on Creating GitHub Apps](https://docs.github.com/en/apps/creating-github-apps)
- [GitHub Docs on Using GitHub Apps](https://docs.github.com/en/apps/using-github-apps/about-using-github-apps)
- [GitHub Docs on Creating OAuth Apps](https://docs.github.com/en/apps/oauth-apps)
- GitHub Docs on Installing OAuth Apps into a [Personal Account](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/installing-an-oauth-app-in-your-personal-account) and [Organization](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/installing-an-oauth-app-in-your-organization)
- [Managing OAuth Apps at the Organization Level](https://docs.github.com/en/organizations/managing-oauth-access-to-your-organizations-data)
- [Managing Programmatic Access at the GitHub Organization Level](https://docs.github.com/en/organizations/managing-programmatic-access-to-your-organization)
- [Building Copilot Extensions](https://docs.github.com/en/copilot/building-copilot-extensions)
- [Managing App/Extension Visibility](https://docs.github.com/en/copilot/building-copilot-extensions/managing-the-availability-of-your-copilot-extension) (including GitHub Marketplace information)
- [Example Implementation in VS Code Repository](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/api/common/extHostMcp.ts#L313)
================================================
FILE: docs/insiders-features.md
================================================
# Insiders Features
Insiders Mode gives you access to experimental features in the GitHub MCP Server. These features may change, evolve, or be removed based on community feedback.
We created this mode to have a way to roll out experimental features and collect feedback. So if you are using Insiders, please don't hesitate to share your feedback with us!
> [!NOTE]
> Features in Insiders Mode are experimental.
## Enabling Insiders Mode
| Method | Remote Server | Local Server |
|--------|---------------|--------------|
| URL path | Append `/insiders` to the URL | N/A |
| Header | `X-MCP-Insiders: true` | N/A |
| CLI flag | N/A | `--insiders` |
| Environment variable | N/A | `GITHUB_INSIDERS=true` |
For configuration examples, see the [Server Configuration Guide](./server-configuration.md#insiders-mode).
---
## MCP Apps
[MCP Apps](https://modelcontextprotocol.io/docs/extensions/apps) is an extension to the Model Context Protocol that enables servers to deliver interactive user interfaces to end users. Instead of returning plain text that the LLM must interpret and relay, tools can render forms, profiles, and dashboards right in the chat using MCP Apps.
This means you can interact with GitHub visually: fill out forms to create issues, see user profiles with avatars, open pull requests — all without leaving your agent chat.
### Supported tools
The following tools have MCP Apps UIs:
| Tool | Description |
|------|-------------|
| `get_me` | Displays your GitHub user profile with avatar, bio, and stats in a rich card |
| `issue_write` | Opens an interactive form to create or update issues |
| `create_pull_request` | Provides a full PR creation form to create a pull request (or a draft pull request) |
### Client requirements
MCP Apps requires a host that supports the [MCP Apps extension](https://modelcontextprotocol.io/docs/extensions/apps). Currently tested and working with:
- **VS Code Insiders** — enable via the `chat.mcp.apps.enabled` setting
- **Visual Studio Code** — enable via the `chat.mcp.apps.enabled` setting
================================================
FILE: docs/installation-guides/README.md
================================================
# GitHub MCP Server Installation Guides
This directory contains detailed installation instructions for the GitHub MCP Server across different host applications and IDEs. Choose the guide that matches your development environment.
## Installation Guides by Host Application
- **[Copilot CLI](install-copilot-cli.md)** - Installation guide for GitHub Copilot CLI
- **[GitHub Copilot in other IDEs](install-other-copilot-ides.md)** - Installation for JetBrains, Visual Studio, Eclipse, and Xcode with GitHub Copilot
- **[Antigravity](install-antigravity.md)** - Installation for Google Antigravity IDE
- **[Claude Applications](install-claude.md)** - Installation guide for Claude Web, Claude Desktop and Claude Code CLI
- **[Cline](install-cline.md)** - Installation guide for Cline
- **[Cursor](install-cursor.md)** - Installation guide for Cursor IDE
- **[Google Gemini CLI](install-gemini-cli.md)** - Installation guide for Google Gemini CLI
- **[OpenAI Codex](install-codex.md)** - Installation guide for OpenAI Codex
- **[Roo Code](install-roo-code.md)** - Installation guide for Roo Code
- **[Windsurf](install-windsurf.md)** - Installation guide for Windsurf IDE
## Support by Host Application
| Host Application | Local GitHub MCP Support | Remote GitHub MCP Support | Prerequisites | Difficulty |
|-----------------|---------------|----------------|---------------|------------|
| Copilot CLI | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
| Copilot in VS Code | ✅ | ✅ Full (OAuth + PAT) | Local: Docker or Go build, GitHub PAT<br>Remote: VS Code 1.101+ | Easy |
| Copilot Coding Agent | ✅ | ✅ Full (on by default; no auth needed) | Any _paid_ copilot license | Default on |
| Copilot in Visual Studio | ✅ | ✅ Full (OAuth + PAT) | Local: Docker or Go build, GitHub PAT<br>Remote: Visual Studio 17.14+ | Easy |
| Copilot in JetBrains | ✅ | ✅ Full (OAuth + PAT) | Local: Docker or Go build, GitHub PAT<br>Remote: JetBrains Copilot Extension v1.5.53+ | Easy |
| Claude Code | ✅ | ✅ PAT + ❌ No OAuth| GitHub MCP Server binary or remote URL, GitHub PAT | Easy |
| Claude Desktop | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Moderate |
| Cline | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
| Cursor | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
| Google Gemini CLI | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
| Roo Code | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
| Windsurf | ✅ | ✅ PAT + ❌ No OAuth | Docker or Go build, GitHub PAT | Easy |
| Copilot in Xcode | ✅ | ✅ Full (OAuth + PAT) | Local: Docker or Go build, GitHub PAT<br>Remote: Copilot for Xcode 0.41.0+ | Easy |
| Copilot in Eclipse | ✅ | ✅ Full (OAuth + PAT) | Local: Docker or Go build, GitHub PAT<br>Remote: Eclipse Plug-in for Copilot 0.10.0+ | Easy |
**Legend:**
- ✅ = Fully supported
- ❌ = Not yet supported
**Note:** Remote MCP support requires host applications to register a GitHub App or OAuth app for OAuth flow support – even if the new OAuth spec is supported by that host app. Currently, only VS Code has full remote GitHub server support.
## Installation Methods
The GitHub MCP Server can be installed using several methods. **Docker is the most popular and recommended approach** for most users, but alternatives are available depending on your needs:
### 🐳 Docker (Most Common & Recommended)
- **Pros**: No local build required, consistent environment, easy updates, works across all platforms
- **Cons**: Requires Docker installed and running
- **Best for**: Most users, especially those already using Docker or wanting the simplest setup
- **Used by**: Claude Desktop, Copilot in VS Code, Cursor, Windsurf, etc.
### 📦 Pre-built Binary (Lightweight Alternative)
- **Pros**: No Docker required, direct execution via stdio, minimal setup
- **Cons**: Need to manually download and manage updates, platform-specific binaries
- **Best for**: Minimal environments, users who prefer not to use Docker
- **Used by**: Claude Code CLI, lightweight setups
### 🔨 Build from Source (Advanced Users)
- **Pros**: Latest features, full customization, no external dependencies
- **Cons**: Requires Go development environment, more complex setup
- **Prerequisites**: [Go 1.24+](https://go.dev/doc/install)
- **Build command**: `go build -o github-mcp-server cmd/github-mcp-server/main.go`
- **Best for**: Developers who want the latest features or need custom modifications
### Important Notes on the GitHub MCP Server
- **Docker Image**: The official Docker image is now `ghcr.io/github/github-mcp-server`
- **npm Package**: The npm package @modelcontextprotocol/server-github is no longer supported as of April 2025
- **Remote Server**: The remote server URL is `https://api.githubcopilot.com/mcp/`
## General Prerequisites
All installations with Personal Access Tokens (PAT) require:
- **GitHub Personal Access Token (PAT)**: [Create one here](https://github.com/settings/personal-access-tokens/new)
Optional (depending on installation method):
- **Docker** (for Docker-based installations): [Download Docker](https://www.docker.com/)
- **Go 1.24+** (for building from source): [Install Go](https://go.dev/doc/install)
## Security Best Practices
Regardless of which installation method you choose, follow these security guidelines:
1. **Secure Token Storage**: Never commit your GitHub PAT to version control
2. **Limit Token Scope**: Only grant necessary permissions to your GitHub PAT
3. **File Permissions**: Restrict access to configuration files containing tokens
4. **Regular Rotation**: Periodically rotate your GitHub Personal Access Tokens
5. **Environment Variables**: Use environment variables when supported by your host
## Getting Help
If you encounter issues:
1. Check the troubleshooting section in your specific installation guide
2. Verify your GitHub PAT has the required permissions
3. Ensure Docker is running (for local installations)
4. Review your host application's logs for error messages
5. Consult the main [README.md](README.md) for additional configuration options
## Configuration Options
After installation, you may want to explore:
- **Toolsets**: Enable/disable specific GitHub API capabilities
- **Read-Only Mode**: Restrict to read-only operations
- **Dynamic Tool Discovery**: Enable tools on-demand
- **Lockdown Mode**: Hide public issue details created by users without push access
================================================
FILE: docs/installation-guides/install-antigravity.md
================================================
# Installing GitHub MCP Server in Antigravity
This guide covers setting up the GitHub MCP Server in Google's Antigravity IDE.
## Prerequisites
- Antigravity IDE installed (latest version)
- GitHub Personal Access Token with appropriate scopes
## Installation Methods
### Option 1: Remote Server (Recommended)
Uses GitHub's hosted server at `https://api.githubcopilot.com/mcp/`.
> [!NOTE]
> We recommend this manual configuration method because the "official" installation via the Antigravity MCP Store currently has known issues (often resulting in Docker errors). This direct remote connection is more reliable.
#### Step 1: Access MCP Configuration
1. Open Antigravity
2. Click the "..." (Additional Options) menu in the Agent panel
3. Select "MCP Servers"
4. Click "Manage MCP Servers"
5. Click "View raw config"
This will open your `mcp_config.json` file at:
- **Windows**: `C:\Users\<USERNAME>\.gemini\antigravity\mcp_config.json`
- **macOS/Linux**: `~/.gemini/antigravity/mcp_config.json`
#### Step 2: Add Configuration
Add the following to your `mcp_config.json`:
```json
{
"mcpServers": {
"github": {
"serverUrl": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_GITHUB_PAT"
}
}
}
}
```
**Important**: Note that Antigravity uses `serverUrl` instead of `url` for HTTP-based MCP servers.
#### Step 3: Configure Your Token
Replace `YOUR_GITHUB_PAT` with your actual GitHub Personal Access Token.
Create a token here: https://github.com/settings/tokens
Recommended scopes:
- `repo` - Full control of private repositories
- `read:org` - Read org and team membership
- `read:user` - Read user profile data
#### Step 4: Restart Antigravity
Close and reopen Antigravity for the changes to take effect.
#### Step 5: Verify Installation
1. Open the MCP Servers panel (... menu → MCP Servers)
2. You should see "github" with a list of available tools
3. You can now use GitHub tools in your conversations
> [!NOTE]
> The status indicator in the MCP Servers panel might not immediately turn green in some versions, but the tools will still function if configured correctly.
### Option 2: Local Docker Server
If you prefer running the server locally with Docker:
```json
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
}
}
}
}
```
**Requirements**:
- Docker Desktop installed and running
- Docker must be in your system PATH
## Troubleshooting
### "Error: serverUrl or command must be specified"
Make sure you're using `serverUrl` (not `url`) for the remote server configuration. Antigravity requires `serverUrl` for HTTP-based MCP servers.
### Server not appearing in MCP list
- Verify JSON syntax in your config file
- Check that your PAT hasn't expired
- Restart Antigravity completely
### Tools not working
- Ensure your PAT has the correct scopes
- Check the MCP Servers panel for error messages
- Verify internet connection for remote server
## Available Tools
Once installed, you'll have access to tools like:
- `create_repository` - Create new GitHub repositories
- `push_files` - Push files to repositories
- `search_repositories` - Search for repositories
- `create_or_update_file` - Manage file content
- `get_file_contents` - Read file content
- And many more...
For a complete list of available tools and features, see the [main README](../../README.md).
## Differences from Other IDEs
- **Configuration key**: Antigravity uses `serverUrl` instead of `url` for HTTP servers
- **Config location**: `.gemini/antigravity/mcp_config.json` instead of `.cursor/mcp.json`
- **Tool limits**: Antigravity recommends keeping total enabled tools under 50 for optimal performance
## Next Steps
- Explore the [Server Configuration Guide](../server-configuration.md) for advanced options
- Check out [toolsets documentation](../../README.md#available-toolsets) to customize available tools
- See the [Remote Server Documentation](../remote-server.md) for more details
================================================
FILE: docs/installation-guides/install-claude.md
================================================
# Install GitHub MCP Server in Claude Applications
## Claude Code CLI
### Prerequisites
- Claude Code CLI installed
- [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
- For local setup: [Docker](https://www.docker.com/) installed and running
- Open Claude Code inside the directory for your project (recommended for best experience and clear scope of configuration)
<details>
<summary><b>Storing Your PAT Securely</b></summary>
<br>
For security, avoid hardcoding your token. One common approach:
1. Store your token in `.env` file
```
GITHUB_PAT=your_token_here
```
2. Add to .gitignore
```bash
echo -e ".env\n.mcp.json" >> .gitignore
```
</details>
### Remote Server Setup (Streamable HTTP)
> **Note**: For Claude Code versions **2.1.1 and newer**, use the `add-json` command format below. For older versions, see the [legacy command format](#for-older-versions-of-claude-code).
>
> **Windows / CLI note**: `claude mcp add-json` may return `Invalid input` when adding an HTTP server. If that happens, use the legacy `claude mcp add --transport http ...` command format below.
1. Run the following command in the terminal (not in Claude Code CLI):
```bash
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'
```
With an environment variable:
```bash
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer '"$(grep GITHUB_PAT .env | cut -d '=' -f2)"'"}}'
```
> **About the `--scope` flag** (optional): Use this to specify where the configuration is stored:
> - `local` (default): Available only to you in the current project (was called `project` in older versions)
> - `project`: Shared with everyone in the project via `.mcp.json` file
> - `user`: Available to you across all projects (was called `global` in older versions)
>
> Example: Add `--scope user` to the end of the command to make it available across all projects.
2. Restart Claude Code
3. Run `claude mcp list` to see if the GitHub server is configured
### Local Server Setup (Docker required)
### With Docker
1. Run the following command in the terminal (not in Claude Code CLI):
```bash
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
```
With an environment variable:
```bash
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$(grep GITHUB_PAT .env | cut -d '=' -f2) -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
```
2. Restart Claude Code
3. Run `claude mcp list` to see if the GitHub server is configured
### With a Binary (no Docker)
1. Download [release binary](https://github.com/github/github-mcp-server/releases)
2. Add to your `PATH`
3. Run:
```bash
claude mcp add-json github '{"command": "github-mcp-server", "args": ["stdio"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"}}'
```
2. Restart Claude Code
3. Run `claude mcp list` to see if the GitHub server is configured
### Verification
```bash
claude mcp list
claude mcp get github
```
### For Older Versions of Claude Code
If you're using Claude Code version **2.1.0 or earlier**, use this legacy command format:
```bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT"
```
With an environment variable:
```bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer $(grep GITHUB_PAT .env | cut -d '=' -f2)"
```
#### Windows (PowerShell)
If you see `missing required argument 'name'`, put the server name immediately after `claude mcp add`:
```powershell
$pat = "YOUR_GITHUB_PAT"
claude mcp add github --transport http https://api.githubcopilot.com/mcp/ -H "Authorization: Bearer $pat"
```
---
## Claude Desktop
> ⚠️ **Note**: Some users have reported compatibility issues with Claude Desktop and Docker-based MCP servers. We're investigating. If you experience issues, try using another MCP host, while we look into it!
### Prerequisites
- Claude Desktop installed (latest version)
- [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
- [Docker](https://www.docker.com/) installed and running
> **Note**: Claude Desktop supports MCP servers that are both local (stdio) and remote ("connectors"). Remote servers can generally be added via Settings → Connectors → "Add custom connector". However, the GitHub remote MCP server requires OAuth authentication through a registered GitHub App (or OAuth App), which is not currently supported. Use the local Docker setup instead.
### Configuration File Location
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux**: `~/.config/Claude/claude_desktop_config.json`
### Local Server Setup (Docker)
Add this codeblock to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
}
}
}
}
```
### Manual Setup Steps
1. Open Claude Desktop
2. Go to Settings → Developer → Edit Config
3. Paste the code block above in your configuration file
4. If you're navigating to the configuration file outside of the app:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
5. Open the file in a text editor
6. Paste one of the code blocks above, based on your chosen configuration (remote or local)
7. Replace `YOUR_GITHUB_PAT` with your actual token or $GITHUB_PAT environment variable
8. Save the file
9. Restart Claude Desktop
---
## Troubleshooting
**Authentication Failed:**
- Verify PAT has `repo` scope
- Check token hasn't expired
**Remote Server:**
gitextract_y8of8_b_/
├── .dockerignore
├── .github/
│ ├── CODEOWNERS
│ ├── ISSUE_TEMPLATE/
│ │ ├── bug_report.md
│ │ └── feature_request.md
│ ├── agents/
│ │ └── go-sdk-tool-migrator.md
│ ├── copilot-instructions.md
│ ├── dependabot.yml
│ ├── licenses.tmpl
│ ├── prompts/
│ │ ├── bug-report-review.prompt.yml
│ │ └── default-issue-review.prompt.yml
│ ├── pull_request_template.md
│ └── workflows/
│ ├── ai-issue-assessment.yml
│ ├── close-inactive-issues.yml
│ ├── code-scanning.yml
│ ├── docker-publish.yml
│ ├── docs-check.yml
│ ├── go.yml
│ ├── goreleaser.yml
│ ├── issue-labeler.yml
│ ├── license-check.yml
│ ├── lint.yml
│ ├── mcp-diff.yml
│ ├── moderator.yml
│ └── registry-releaser.yml
├── .gitignore
├── .golangci.yml
├── .goreleaser.yaml
├── .vscode/
│ └── launch.json
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── Dockerfile
├── LICENSE
├── README.md
├── SECURITY.md
├── SUPPORT.md
├── docs/
│ ├── error-handling.md
│ ├── host-integration.md
│ ├── insiders-features.md
│ ├── installation-guides/
│ │ ├── README.md
│ │ ├── install-antigravity.md
│ │ ├── install-claude.md
│ │ ├── install-cline.md
│ │ ├── install-codex.md
│ │ ├── install-copilot-cli.md
│ │ ├── install-cursor.md
│ │ ├── install-gemini-cli.md
│ │ ├── install-other-copilot-ides.md
│ │ ├── install-roo-code.md
│ │ ├── install-rovo-dev-cli.md
│ │ └── install-windsurf.md
│ ├── policies-and-governance.md
│ ├── remote-server.md
│ ├── scope-filtering.md
│ ├── server-configuration.md
│ ├── streamable-http.md
│ ├── testing.md
│ ├── tool-renaming.md
│ └── toolsets-and-icons.md
├── e2e/
│ ├── README.md
│ └── e2e_test.go
├── gemini-extension.json
├── go.mod
├── go.sum
├── internal/
│ ├── ghmcp/
│ │ ├── server.go
│ │ └── server_test.go
│ ├── githubv4mock/
│ │ ├── githubv4mock.go
│ │ ├── local_round_tripper.go
│ │ ├── objects_are_equal_values.go
│ │ ├── objects_are_equal_values_test.go
│ │ └── query.go
│ ├── profiler/
│ │ └── profiler.go
│ └── toolsnaps/
│ ├── toolsnaps.go
│ └── toolsnaps_test.go
├── pkg/
│ ├── buffer/
│ │ ├── buffer.go
│ │ └── buffer_test.go
│ ├── context/
│ │ ├── graphql_features.go
│ │ ├── mcp_info.go
│ │ ├── request.go
│ │ └── token.go
│ ├── errors/
│ │ ├── error.go
│ │ └── error_test.go
│ ├── github/
│ │ ├── __toolsnaps__/
│ │ │ ├── actions_get.snap
│ │ │ ├── actions_list.snap
│ │ │ ├── actions_run_trigger.snap
│ │ │ ├── add_comment_to_pending_review.snap
│ │ │ ├── add_issue_comment.snap
│ │ │ ├── add_reply_to_pull_request_comment.snap
│ │ │ ├── assign_copilot_to_issue.snap
│ │ │ ├── create_branch.snap
│ │ │ ├── create_gist.snap
│ │ │ ├── create_issue.snap
│ │ │ ├── create_or_update_file.snap
│ │ │ ├── create_pull_request.snap
│ │ │ ├── create_repository.snap
│ │ │ ├── delete_file.snap
│ │ │ ├── dismiss_notification.snap
│ │ │ ├── fork_repository.snap
│ │ │ ├── get_code_scanning_alert.snap
│ │ │ ├── get_commit.snap
│ │ │ ├── get_dependabot_alert.snap
│ │ │ ├── get_discussion.snap
│ │ │ ├── get_discussion_comments.snap
│ │ │ ├── get_file_contents.snap
│ │ │ ├── get_gist.snap
│ │ │ ├── get_global_security_advisory.snap
│ │ │ ├── get_job_logs.snap
│ │ │ ├── get_label.snap
│ │ │ ├── get_latest_release.snap
│ │ │ ├── get_me.snap
│ │ │ ├── get_notification_details.snap
│ │ │ ├── get_release_by_tag.snap
│ │ │ ├── get_repository_tree.snap
│ │ │ ├── get_secret_scanning_alert.snap
│ │ │ ├── get_tag.snap
│ │ │ ├── get_team_members.snap
│ │ │ ├── get_teams.snap
│ │ │ ├── issue_read.snap
│ │ │ ├── issue_write.snap
│ │ │ ├── label_write.snap
│ │ │ ├── list_branches.snap
│ │ │ ├── list_code_scanning_alerts.snap
│ │ │ ├── list_commits.snap
│ │ │ ├── list_dependabot_alerts.snap
│ │ │ ├── list_discussion_categories.snap
│ │ │ ├── list_discussions.snap
│ │ │ ├── list_gists.snap
│ │ │ ├── list_global_security_advisories.snap
│ │ │ ├── list_issue_types.snap
│ │ │ ├── list_issues.snap
│ │ │ ├── list_label.snap
│ │ │ ├── list_notifications.snap
│ │ │ ├── list_org_repository_security_advisories.snap
│ │ │ ├── list_pull_requests.snap
│ │ │ ├── list_releases.snap
│ │ │ ├── list_repository_security_advisories.snap
│ │ │ ├── list_secret_scanning_alerts.snap
│ │ │ ├── list_starred_repositories.snap
│ │ │ ├── list_tags.snap
│ │ │ ├── manage_notification_subscription.snap
│ │ │ ├── manage_repository_notification_subscription.snap
│ │ │ ├── mark_all_notifications_read.snap
│ │ │ ├── merge_pull_request.snap
│ │ │ ├── projects_get.snap
│ │ │ ├── projects_list.snap
│ │ │ ├── projects_write.snap
│ │ │ ├── pull_request_read.snap
│ │ │ ├── pull_request_review_write.snap
│ │ │ ├── push_files.snap
│ │ │ ├── request_copilot_review.snap
│ │ │ ├── search_code.snap
│ │ │ ├── search_issues.snap
│ │ │ ├── search_orgs.snap
│ │ │ ├── search_pull_requests.snap
│ │ │ ├── search_repositories.snap
│ │ │ ├── search_users.snap
│ │ │ ├── star_repository.snap
│ │ │ ├── sub_issue_write.snap
│ │ │ ├── unstar_repository.snap
│ │ │ ├── update_gist.snap
│ │ │ ├── update_pull_request.snap
│ │ │ └── update_pull_request_branch.snap
│ │ ├── actions.go
│ │ ├── actions_test.go
│ │ ├── code_scanning.go
│ │ ├── code_scanning_test.go
│ │ ├── context_tools.go
│ │ ├── context_tools_test.go
│ │ ├── copilot.go
│ │ ├── copilot_test.go
│ │ ├── dependabot.go
│ │ ├── dependabot_test.go
│ │ ├── dependencies.go
│ │ ├── dependencies_test.go
│ │ ├── deprecated_tool_aliases.go
│ │ ├── discussions.go
│ │ ├── discussions_test.go
│ │ ├── dynamic_tools.go
│ │ ├── dynamic_tools_test.go
│ │ ├── feature_flags.go
│ │ ├── feature_flags_test.go
│ │ ├── gists.go
│ │ ├── gists_test.go
│ │ ├── git.go
│ │ ├── git_test.go
│ │ ├── helper_test.go
│ │ ├── inventory.go
│ │ ├── issues.go
│ │ ├── issues_test.go
│ │ ├── labels.go
│ │ ├── labels_test.go
│ │ ├── minimal_types.go
│ │ ├── notifications.go
│ │ ├── notifications_test.go
│ │ ├── params.go
│ │ ├── params_test.go
│ │ ├── projects.go
│ │ ├── projects_test.go
│ │ ├── prompts.go
│ │ ├── pullrequests.go
│ │ ├── pullrequests_test.go
│ │ ├── repositories.go
│ │ ├── repositories_helper.go
│ │ ├── repositories_test.go
│ │ ├── repository_resource.go
│ │ ├── repository_resource_completions.go
│ │ ├── repository_resource_completions_test.go
│ │ ├── repository_resource_test.go
│ │ ├── resources.go
│ │ ├── scope_filter.go
│ │ ├── scope_filter_test.go
│ │ ├── search.go
│ │ ├── search_test.go
│ │ ├── search_utils.go
│ │ ├── search_utils_test.go
│ │ ├── secret_scanning.go
│ │ ├── secret_scanning_test.go
│ │ ├── security_advisories.go
│ │ ├── security_advisories_test.go
│ │ ├── server.go
│ │ ├── server_test.go
│ │ ├── tools.go
│ │ ├── tools_test.go
│ │ ├── tools_validation_test.go
│ │ ├── toolset_icons_test.go
│ │ ├── toolset_instructions.go
│ │ ├── ui_capability.go
│ │ ├── ui_capability_test.go
│ │ ├── ui_dist/
│ │ │ ├── .gitkeep
│ │ │ └── .placeholder.html
│ │ ├── ui_embed.go
│ │ ├── ui_resources.go
│ │ └── workflow_prompts.go
│ ├── http/
│ │ ├── handler.go
│ │ ├── handler_test.go
│ │ ├── headers/
│ │ │ ├── headers.go
│ │ │ ├── parse.go
│ │ │ └── parse_test.go
│ │ ├── mark/
│ │ │ └── mark.go
│ │ ├── middleware/
│ │ │ ├── mcp_parse.go
│ │ │ ├── mcp_parse_test.go
│ │ │ ├── pat_scope.go
│ │ │ ├── pat_scope_test.go
│ │ │ ├── request_config.go
│ │ │ ├── scope_challenge.go
│ │ │ ├── token.go
│ │ │ └── token_test.go
│ │ ├── oauth/
│ │ │ ├── oauth.go
│ │ │ └── oauth_test.go
│ │ ├── server.go
│ │ └── transport/
│ │ ├── bearer.go
│ │ ├── graphql_features.go
│ │ ├── graphql_features_test.go
│ │ └── user_agent.go
│ ├── inventory/
│ │ ├── builder.go
│ │ ├── errors.go
│ │ ├── filters.go
│ │ ├── instructions.go
│ │ ├── instructions_test.go
│ │ ├── prompts.go
│ │ ├── registry.go
│ │ ├── registry_test.go
│ │ ├── resources.go
│ │ └── server_tool.go
│ ├── lockdown/
│ │ ├── lockdown.go
│ │ └── lockdown_test.go
│ ├── log/
│ │ ├── io.go
│ │ └── io_test.go
│ ├── octicons/
│ │ ├── octicons.go
│ │ ├── octicons_test.go
│ │ └── required_icons.txt
│ ├── raw/
│ │ ├── raw.go
│ │ └── raw_test.go
│ ├── sanitize/
│ │ ├── sanitize.go
│ │ └── sanitize_test.go
│ ├── scopes/
│ │ ├── fetcher.go
│ │ ├── fetcher_test.go
│ │ ├── map.go
│ │ ├── map_test.go
│ │ ├── scopes.go
│ │ └── scopes_test.go
│ ├── tooldiscovery/
│ │ ├── search.go
│ │ └── search_test.go
│ ├── translations/
│ │ └── translations.go
│ └── utils/
│ ├── api.go
│ ├── api_test.go
│ ├── result.go
│ └── token.go
├── script/
│ ├── build-ui
│ ├── conformance-test
│ ├── fetch-icons
│ ├── generate-docs
│ ├── get-discussions
│ ├── get-me
│ ├── licenses
│ ├── licenses-check
│ ├── lint
│ ├── list-scopes
│ ├── prettyprint-log
│ ├── tag-release
│ └── test
├── server.json
├── third-party/
│ ├── github.com/
│ │ ├── aymerick/
│ │ │ └── douceur/
│ │ │ └── LICENSE
│ │ ├── fsnotify/
│ │ │ └── fsnotify/
│ │ │ └── LICENSE
│ │ ├── go-chi/
│ │ │ └── chi/
│ │ │ └── v5/
│ │ │ └── LICENSE
│ │ ├── go-openapi/
│ │ │ ├── jsonpointer/
│ │ │ │ └── LICENSE
│ │ │ └── swag/
│ │ │ └── LICENSE
│ │ ├── go-viper/
│ │ │ └── mapstructure/
│ │ │ └── v2/
│ │ │ └── LICENSE
│ │ ├── google/
│ │ │ ├── go-github/
│ │ │ │ └── v82/
│ │ │ │ └── github/
│ │ │ │ └── LICENSE
│ │ │ ├── go-querystring/
│ │ │ │ └── query/
│ │ │ │ └── LICENSE
│ │ │ └── jsonschema-go/
│ │ │ └── jsonschema/
│ │ │ └── LICENSE
│ │ ├── gorilla/
│ │ │ └── css/
│ │ │ └── scanner/
│ │ │ └── LICENSE
│ │ ├── inconshreveable/
│ │ │ └── mousetrap/
│ │ │ └── LICENSE
│ │ ├── josephburnett/
│ │ │ └── jd/
│ │ │ └── v2/
│ │ │ └── LICENSE
│ │ ├── josharian/
│ │ │ └── intern/
│ │ │ └── license.md
│ │ ├── lithammer/
│ │ │ └── fuzzysearch/
│ │ │ └── fuzzy/
│ │ │ └── LICENSE
│ │ ├── mailru/
│ │ │ └── easyjson/
│ │ │ └── LICENSE
│ │ ├── microcosm-cc/
│ │ │ └── bluemonday/
│ │ │ └── LICENSE.md
│ │ ├── modelcontextprotocol/
│ │ │ └── go-sdk/
│ │ │ └── LICENSE
│ │ ├── muesli/
│ │ │ └── cache2go/
│ │ │ └── LICENSE.txt
│ │ ├── pelletier/
│ │ │ └── go-toml/
│ │ │ └── v2/
│ │ │ └── LICENSE
│ │ ├── sagikazarmark/
│ │ │ └── locafero/
│ │ │ └── LICENSE
│ │ ├── segmentio/
│ │ │ ├── asm/
│ │ │ │ └── LICENSE
│ │ │ └── encoding/
│ │ │ └── LICENSE
│ │ ├── shurcooL/
│ │ │ ├── githubv4/
│ │ │ │ └── LICENSE
│ │ │ └── graphql/
│ │ │ └── LICENSE
│ │ ├── sourcegraph/
│ │ │ └── conc/
│ │ │ └── LICENSE
│ │ ├── spf13/
│ │ │ ├── afero/
│ │ │ │ └── LICENSE.txt
│ │ │ ├── cast/
│ │ │ │ └── LICENSE
│ │ │ ├── cobra/
│ │ │ │ └── LICENSE.txt
│ │ │ ├── pflag/
│ │ │ │ └── LICENSE
│ │ │ └── viper/
│ │ │ └── LICENSE
│ │ ├── subosito/
│ │ │ └── gotenv/
│ │ │ └── LICENSE
│ │ └── yosida95/
│ │ └── uritemplate/
│ │ └── v3/
│ │ └── LICENSE
│ ├── go.yaml.in/
│ │ └── yaml/
│ │ └── v3/
│ │ ├── LICENSE
│ │ └── NOTICE
│ ├── golang.org/
│ │ └── x/
│ │ ├── exp/
│ │ │ └── slices/
│ │ │ └── LICENSE
│ │ ├── net/
│ │ │ └── html/
│ │ │ └── LICENSE
│ │ ├── sys/
│ │ │ └── LICENSE
│ │ └── text/
│ │ └── LICENSE
│ └── gopkg.in/
│ └── yaml.v3/
│ ├── LICENSE
│ └── NOTICE
├── third-party-licenses.darwin.md
├── third-party-licenses.linux.md
├── third-party-licenses.windows.md
└── ui/
├── package.json
├── src/
│ ├── apps/
│ │ ├── get-me/
│ │ │ ├── App.tsx
│ │ │ └── index.html
│ │ ├── issue-write/
│ │ │ ├── App.tsx
│ │ │ └── index.html
│ │ └── pr-write/
│ │ ├── App.tsx
│ │ └── index.html
│ ├── components/
│ │ ├── AppProvider.tsx
│ │ └── MarkdownEditor.tsx
│ ├── hooks/
│ │ └── useMcpApp.ts
│ └── vite-env.d.ts
├── tsconfig.json
└── vite.config.ts
SYMBOL INDEX (1476 symbols across 147 files)
FILE: e2e/e2e_test.go
constant minRateLimitRemaining (line 43) | minRateLimitRemaining = 50
function getE2EToken (line 46) | func getE2EToken(t *testing.T) string {
function getE2EHost (line 57) | func getE2EHost() string {
function getRESTClient (line 64) | func getRESTClient(t *testing.T) *gogithub.Client {
function waitForRateLimit (line 84) | func waitForRateLimit(t *testing.T) {
function ensureDockerImageBuilt (line 113) | func ensureDockerImageBuilt(t *testing.T) {
type clientOpts (line 130) | type clientOpts struct
type clientOption (line 136) | type clientOption
function withToolsets (line 140) | func withToolsets(toolsets []string) clientOption {
function setupMCPClient (line 146) | func setupMCPClient(t *testing.T, options ...clientOption) *mcp.ClientSe...
function TestGetMe (line 252) | func TestGetMe(t *testing.T) {
function TestToolsets (line 283) | func TestToolsets(t *testing.T) {
function TestTags (line 310) | func TestTags(t *testing.T) {
function TestFileDeletion (line 442) | func TestFileDeletion(t *testing.T) {
function TestDirectoryDeletion (line 629) | func TestDirectoryDeletion(t *testing.T) {
function TestRequestCopilotReview (line 842) | func TestRequestCopilotReview(t *testing.T) {
function TestAssignCopilotToIssue (line 1002) | func TestAssignCopilotToIssue(t *testing.T) {
function TestPullRequestAtomicCreateAndSubmit (line 1107) | func TestPullRequestAtomicCreateAndSubmit(t *testing.T) {
function TestPullRequestReviewCommentSubmit (line 1268) | func TestPullRequestReviewCommentSubmit(t *testing.T) {
function TestPullRequestReviewDeletion (line 1526) | func TestPullRequestReviewDeletion(t *testing.T) {
FILE: internal/ghmcp/server.go
type githubClients (line 31) | type githubClients struct
function createGitHubClients (line 40) | func createGitHubClients(cfg github.MCPServerConfig, apiHost utils.APIHo...
function NewStdioMCPServer (line 104) | func NewStdioMCPServer(ctx context.Context, cfg github.MCPServerConfig) ...
type StdioServerConfig (line 170) | type StdioServerConfig struct
function RunStdioServer (line 228) | func RunStdioServer(cfg StdioServerConfig) error {
function createFeatureChecker (line 333) | func createFeatureChecker(enabledFeatures []string) inventory.FeatureFla...
function addUserAgentsMiddleware (line 344) | func addUserAgentsMiddleware(cfg github.MCPServerConfig, restClient *gog...
function fetchTokenScopesForHost (line 381) | func fetchTokenScopesForHost(ctx context.Context, token, host string) ([...
FILE: internal/githubv4mock/githubv4mock.go
type Matcher (line 12) | type Matcher struct
function NewQueryMatcher (line 22) | func NewQueryMatcher(query any, variables map[string]any, response GQLRe...
function NewMutationMatcher (line 43) | func NewMutationMatcher(mutation any, input any, variables map[string]an...
type GQLResponse (line 65) | type GQLResponse struct
function DataResponse (line 73) | func DataResponse(data map[string]any) GQLResponse {
function ErrorResponse (line 81) | func ErrorResponse(errorMsg string) GQLResponse {
function githubv4InputStructToMap (line 96) | func githubv4InputStructToMap(s any) (map[string]any, error) {
function NewMockedHTTPClient (line 151) | func NewMockedHTTPClient(ms ...Matcher) *http.Client {
type gqlRequest (line 207) | type gqlRequest struct
function parseBody (line 212) | func parseBody(r io.Reader) (gqlRequest, error) {
function Ptr (line 218) | func Ptr[T any](v T) *T { return &v }
FILE: internal/githubv4mock/local_round_tripper.go
type localRoundTripper (line 36) | type localRoundTripper struct
method RoundTrip (line 40) | func (l localRoundTripper) RoundTrip(req *http.Request) (*http.Respons...
FILE: internal/githubv4mock/objects_are_equal_values.go
function objectsAreEqualValues (line 36) | func objectsAreEqualValues(expected, actual any) bool {
function objectsAreEqual (line 73) | func objectsAreEqual(expected, actual any) bool {
function isNumericType (line 98) | func isNumericType(t reflect.Type) bool {
function isNil (line 102) | func isNil(i any) bool {
FILE: internal/githubv4mock/objects_are_equal_values_test.go
function TestObjectsAreEqualValues (line 37) | func TestObjectsAreEqualValues(t *testing.T) {
FILE: internal/githubv4mock/query.go
function constructQuery (line 39) | func constructQuery(v any, variables map[string]any) string {
function constructMutation (line 47) | func constructMutation(v any, variables map[string]any) string {
function queryArguments (line 58) | func queryArguments(variables map[string]any) string {
function writeArgumentType (line 83) | func writeArgumentType(w io.Writer, t reflect.Type, value bool) {
function query (line 115) | func query(v any) string {
function writeQuery (line 123) | func writeQuery(w io.Writer, t reflect.Type, inline bool) {
FILE: internal/profiler/profiler.go
type Profile (line 16) | type Profile struct
method String (line 28) | func (p *Profile) String() string {
function safeMemoryDelta (line 39) | func safeMemoryDelta(after, before uint64) int64 {
type Profiler (line 59) | type Profiler struct
method ProfileFunc (line 73) | func (p *Profiler) ProfileFunc(ctx context.Context, operation string, ...
method ProfileFuncWithMetrics (line 104) | func (p *Profiler) ProfileFuncWithMetrics(ctx context.Context, operati...
method Start (line 138) | func (p *Profiler) Start(ctx context.Context, operation string) func(l...
function New (line 65) | func New(logger *slog.Logger, enabled bool) *Profiler {
function IsProfilingEnabled (line 175) | func IsProfilingEnabled() bool {
function Init (line 183) | func Init(logger *slog.Logger, enabled bool) {
function InitFromEnv (line 188) | func InitFromEnv(logger *slog.Logger) {
function ProfileFunc (line 193) | func ProfileFunc(ctx context.Context, operation string, fn func() error)...
function ProfileFuncWithMetrics (line 201) | func ProfileFuncWithMetrics(ctx context.Context, operation string, fn fu...
function Start (line 210) | func Start(ctx context.Context, operation string) func(int, int64) *Prof...
FILE: internal/toolsnaps/toolsnaps.go
function Test (line 21) | func Test(toolName string, tool any) error {
function writeSnap (line 69) | func writeSnap(snapPath string, contents []byte) error {
function sortJSONKeys (line 94) | func sortJSONKeys(jsonData []byte) ([]byte, error) {
FILE: internal/toolsnaps/toolsnaps_test.go
type dummyTool (line 13) | type dummyTool struct
function withIsolatedWorkingDir (line 19) | func withIsolatedWorkingDir(t *testing.T) {
function TestSnapshotDoesNotExistNotInCI (line 27) | func TestSnapshotDoesNotExistNotInCI(t *testing.T) {
function TestSnapshotDoesNotExistInCI (line 44) | func TestSnapshotDoesNotExistInCI(t *testing.T) {
function TestSnapshotExistsMatch (line 62) | func TestSnapshotExistsMatch(t *testing.T) {
function TestSnapshotExistsDiff (line 78) | func TestSnapshotExistsDiff(t *testing.T) {
function TestUpdateToolsnaps (line 97) | func TestUpdateToolsnaps(t *testing.T) {
function TestMalformedSnapshotJSON (line 116) | func TestMalformedSnapshotJSON(t *testing.T) {
function TestSortJSONKeys (line 135) | func TestSortJSONKeys(t *testing.T) {
function TestSortJSONKeysIdempotent (line 177) | func TestSortJSONKeysIdempotent(t *testing.T) {
function TestToolSnapKeysSorted (line 193) | func TestToolSnapKeysSorted(t *testing.T) {
function TestStructFieldOrderingSortedAlphabetically (line 256) | func TestStructFieldOrderingSortedAlphabetically(t *testing.T) {
FILE: pkg/buffer/buffer.go
constant maxLineSize (line 13) | maxLineSize = 10 * 1024 * 1024
function ProcessResponseAsRingBufferToEnd (line 34) | func ProcessResponseAsRingBufferToEnd(httpResp *http.Response, maxJobLog...
FILE: pkg/buffer/buffer_test.go
function TestProcessResponseAsRingBufferToEnd (line 14) | func TestProcessResponseAsRingBufferToEnd(t *testing.T) {
FILE: pkg/context/graphql_features.go
type graphQLFeaturesKey (line 6) | type graphQLFeaturesKey struct
function WithGraphQLFeatures (line 9) | func WithGraphQLFeatures(ctx context.Context, features ...string) contex...
function GetGraphQLFeatures (line 14) | func GetGraphQLFeatures(ctx context.Context) []string {
FILE: pkg/context/mcp_info.go
type mcpMethodInfoCtx (line 5) | type mcpMethodInfoCtx
type MCPMethodInfo (line 14) | type MCPMethodInfo struct
function WithMCPMethodInfo (line 29) | func WithMCPMethodInfo(ctx context.Context, info *MCPMethodInfo) context...
function MCPMethod (line 34) | func MCPMethod(ctx context.Context) (*MCPMethodInfo, bool) {
FILE: pkg/context/request.go
type readonlyCtxKey (line 6) | type readonlyCtxKey struct
function WithReadonly (line 9) | func WithReadonly(ctx context.Context, enabled bool) context.Context {
function IsReadonly (line 14) | func IsReadonly(ctx context.Context) bool {
type toolsetsCtxKey (line 22) | type toolsetsCtxKey struct
function WithToolsets (line 25) | func WithToolsets(ctx context.Context, toolsets []string) context.Context {
function GetToolsets (line 30) | func GetToolsets(ctx context.Context) []string {
type toolsCtxKey (line 38) | type toolsCtxKey struct
function WithTools (line 41) | func WithTools(ctx context.Context, tools []string) context.Context {
function GetTools (line 46) | func GetTools(ctx context.Context) []string {
type lockdownCtxKey (line 54) | type lockdownCtxKey struct
function WithLockdownMode (line 57) | func WithLockdownMode(ctx context.Context, enabled bool) context.Context {
function IsLockdownMode (line 62) | func IsLockdownMode(ctx context.Context) bool {
type insidersCtxKey (line 70) | type insidersCtxKey struct
function WithInsidersMode (line 73) | func WithInsidersMode(ctx context.Context, enabled bool) context.Context {
function IsInsidersMode (line 78) | func IsInsidersMode(ctx context.Context) bool {
type excludeToolsCtxKey (line 86) | type excludeToolsCtxKey struct
function WithExcludeTools (line 89) | func WithExcludeTools(ctx context.Context, tools []string) context.Conte...
function GetExcludeTools (line 94) | func GetExcludeTools(ctx context.Context) []string {
type headerFeaturesCtxKey (line 102) | type headerFeaturesCtxKey struct
function WithHeaderFeatures (line 105) | func WithHeaderFeatures(ctx context.Context, features []string) context....
function GetHeaderFeatures (line 110) | func GetHeaderFeatures(ctx context.Context) []string {
type uiSupportCtxKey (line 118) | type uiSupportCtxKey struct
function WithUISupport (line 123) | func WithUISupport(ctx context.Context, supported bool) context.Context {
function HasUISupport (line 128) | func HasUISupport(ctx context.Context) (supported bool, ok bool) {
FILE: pkg/context/token.go
type tokenCtxKey (line 9) | type tokenCtxKey struct
type TokenInfo (line 11) | type TokenInfo struct
function WithTokenInfo (line 17) | func WithTokenInfo(ctx context.Context, tokenInfo *TokenInfo) context.Co...
function GetTokenInfo (line 22) | func GetTokenInfo(ctx context.Context) (*TokenInfo, bool) {
type tokenScopesKey (line 29) | type tokenScopesKey struct
function WithTokenScopes (line 32) | func WithTokenScopes(ctx context.Context, scopes []string) context.Conte...
function GetTokenScopes (line 37) | func GetTokenScopes(ctx context.Context) ([]string, bool) {
FILE: pkg/errors/error.go
type GitHubAPIError (line 13) | type GitHubAPIError struct
method Error (line 28) | func (e *GitHubAPIError) Error() string {
function newGitHubAPIError (line 20) | func newGitHubAPIError(message string, resp *github.Response, err error)...
type GitHubGraphQLError (line 32) | type GitHubGraphQLError struct
method Error (line 44) | func (e *GitHubGraphQLError) Error() string {
function newGitHubGraphQLError (line 37) | func newGitHubGraphQLError(message string, err error) *GitHubGraphQLError {
type GitHubRawAPIError (line 48) | type GitHubRawAPIError struct
method Error (line 62) | func (e *GitHubRawAPIError) Error() string {
function newGitHubRawAPIError (line 54) | func newGitHubRawAPIError(message string, resp *http.Response, err error...
type GitHubErrorKey (line 66) | type GitHubErrorKey struct
type GitHubCtxErrors (line 67) | type GitHubCtxErrors struct
function ContextWithGitHubErrors (line 74) | func ContextWithGitHubErrors(ctx context.Context) context.Context {
function GetGitHubAPIErrors (line 92) | func GetGitHubAPIErrors(ctx context.Context) ([]*GitHubAPIError, error) {
function GetGitHubGraphQLErrors (line 100) | func GetGitHubGraphQLErrors(ctx context.Context) ([]*GitHubGraphQLError,...
function GetGitHubRawAPIErrors (line 108) | func GetGitHubRawAPIErrors(ctx context.Context) ([]*GitHubRawAPIError, e...
function NewGitHubAPIErrorToCtx (line 115) | func NewGitHubAPIErrorToCtx(ctx context.Context, message string, resp *g...
function NewGitHubGraphQLErrorToCtx (line 123) | func NewGitHubGraphQLErrorToCtx(ctx context.Context, message string, err...
function addGitHubAPIErrorToContext (line 131) | func addGitHubAPIErrorToContext(ctx context.Context, err *GitHubAPIError...
function addGitHubGraphQLErrorToContext (line 139) | func addGitHubGraphQLErrorToContext(ctx context.Context, err *GitHubGrap...
function addRawAPIErrorToContext (line 147) | func addRawAPIErrorToContext(ctx context.Context, err *GitHubRawAPIError...
function NewGitHubAPIErrorResponse (line 157) | func NewGitHubAPIErrorResponse(ctx context.Context, message string, resp...
function NewGitHubGraphQLErrorResponse (line 166) | func NewGitHubGraphQLErrorResponse(ctx context.Context, message string, ...
function NewGitHubRawAPIErrorResponse (line 175) | func NewGitHubRawAPIErrorResponse(ctx context.Context, message string, r...
function NewGitHubAPIStatusErrorResponse (line 186) | func NewGitHubAPIStatusErrorResponse(ctx context.Context, message string...
FILE: pkg/errors/error_test.go
function TestGitHubErrorContext (line 14) | func TestGitHubErrorContext(t *testing.T) {
function TestGitHubErrorTypes (line 366) | func TestGitHubErrorTypes(t *testing.T) {
function TestMiddlewareScenario (line 390) | func TestMiddlewareScenario(t *testing.T) {
FILE: pkg/github/actions.go
constant DescriptionRepositoryOwner (line 25) | DescriptionRepositoryOwner = "Repository owner"
constant DescriptionRepositoryName (line 26) | DescriptionRepositoryName = "Repository name"
constant actionsMethodListWorkflows (line 31) | actionsMethodListWorkflows = "list_workflows"
constant actionsMethodListWorkflowRuns (line 32) | actionsMethodListWorkflowRuns = "list_workflow_runs"
constant actionsMethodListWorkflowJobs (line 33) | actionsMethodListWorkflowJobs = "list_workflow_jobs"
constant actionsMethodListWorkflowArtifacts (line 34) | actionsMethodListWorkflowArtifacts = "list_workflow_run_artifacts"
constant actionsMethodGetWorkflow (line 35) | actionsMethodGetWorkflow = "get_workflow"
constant actionsMethodGetWorkflowRun (line 36) | actionsMethodGetWorkflowRun = "get_workflow_run"
constant actionsMethodGetWorkflowJob (line 37) | actionsMethodGetWorkflowJob = "get_workflow_job"
constant actionsMethodGetWorkflowRunUsage (line 38) | actionsMethodGetWorkflowRunUsage = "get_workflow_run_usage"
constant actionsMethodGetWorkflowRunLogsURL (line 39) | actionsMethodGetWorkflowRunLogsURL = "get_workflow_run_logs_url"
constant actionsMethodDownloadWorkflowArtifact (line 40) | actionsMethodDownloadWorkflowArtifact = "download_workflow_run_artifact"
constant actionsMethodRunWorkflow (line 41) | actionsMethodRunWorkflow = "run_workflow"
constant actionsMethodRerunWorkflowRun (line 42) | actionsMethodRerunWorkflowRun = "rerun_workflow_run"
constant actionsMethodRerunFailedJobs (line 43) | actionsMethodRerunFailedJobs = "rerun_failed_jobs"
constant actionsMethodCancelWorkflowRun (line 44) | actionsMethodCancelWorkflowRun = "cancel_workflow_run"
constant actionsMethodDeleteWorkflowRunLogs (line 45) | actionsMethodDeleteWorkflowRunLogs = "delete_workflow_run_logs"
function handleFailedJobLogs (line 49) | func handleFailedJobLogs(ctx context.Context, client *github.Client, own...
function handleSingleJobLogs (line 114) | func handleSingleJobLogs(ctx context.Context, client *github.Client, own...
function getJobLogData (line 129) | func getJobLogData(ctx context.Context, client *github.Client, owner, re...
function downloadLogContent (line 167) | func downloadLogContent(ctx context.Context, logURL string, tailLines in...
function ActionsList (line 200) | func ActionsList(t translations.TranslationHelperFunc) inventory.ServerT...
function ActionsGet (line 395) | func ActionsGet(t translations.TranslationHelperFunc) inventory.ServerTo...
function ActionsRunTrigger (line 503) | func ActionsRunTrigger(t translations.TranslationHelperFunc) inventory.S...
function ActionsGetJobLogs (line 621) | func ActionsGetJobLogs(t translations.TranslationHelperFunc) inventory.S...
function getWorkflow (line 739) | func getWorkflow(ctx context.Context, client *github.Client, owner, repo...
function getWorkflowRun (line 763) | func getWorkflowRun(ctx context.Context, client *github.Client, owner, r...
function getWorkflowJob (line 776) | func getWorkflowJob(ctx context.Context, client *github.Client, owner, r...
function listWorkflows (line 789) | func listWorkflows(ctx context.Context, client *github.Client, owner, re...
function listWorkflowRuns (line 809) | func listWorkflowRuns(ctx context.Context, client *github.Client, args m...
function listWorkflowJobs (line 859) | func listWorkflowJobs(ctx context.Context, client *github.Client, args m...
function listWorkflowArtifacts (line 898) | func listWorkflowArtifacts(ctx context.Context, client *github.Client, o...
function downloadWorkflowArtifact (line 918) | func downloadWorkflowArtifact(ctx context.Context, client *github.Client...
function getWorkflowRunLogsURL (line 942) | func getWorkflowRunLogsURL(ctx context.Context, client *github.Client, o...
function getWorkflowRunUsage (line 967) | func getWorkflowRunUsage(ctx context.Context, client *github.Client, own...
function runWorkflow (line 982) | func runWorkflow(ctx context.Context, client *github.Client, owner, repo...
function rerunWorkflowRun (line 1023) | func rerunWorkflowRun(ctx context.Context, client *github.Client, owner,...
function rerunFailedJobs (line 1045) | func rerunFailedJobs(ctx context.Context, client *github.Client, owner, ...
function cancelWorkflowRun (line 1067) | func cancelWorkflowRun(ctx context.Context, client *github.Client, owner...
function deleteWorkflowRunLogs (line 1092) | func deleteWorkflowRunLogs(ctx context.Context, client *github.Client, o...
FILE: pkg/github/actions_test.go
function Test_ActionsList (line 19) | func Test_ActionsList(t *testing.T) {
function Test_ActionsList_ListWorkflows (line 33) | func Test_ActionsList_ListWorkflows(t *testing.T) {
function Test_ActionsList_ListWorkflowRuns (line 117) | func Test_ActionsList_ListWorkflowRuns(t *testing.T) {
function Test_ActionsGet (line 212) | func Test_ActionsGet(t *testing.T) {
function Test_ActionsGet_GetWorkflow (line 227) | func Test_ActionsGet_GetWorkflow(t *testing.T) {
function Test_ActionsGet_GetWorkflowRun (line 270) | func Test_ActionsGet_GetWorkflowRun(t *testing.T) {
function Test_ActionsRunTrigger (line 313) | func Test_ActionsRunTrigger(t *testing.T) {
function Test_ActionsRunTrigger_RunWorkflow (line 330) | func Test_ActionsRunTrigger_RunWorkflow(t *testing.T) {
function Test_ActionsRunTrigger_CancelWorkflowRun (line 411) | func Test_ActionsRunTrigger_CancelWorkflowRun(t *testing.T) {
function Test_ActionsGetJobLogs (line 497) | func Test_ActionsGetJobLogs(t *testing.T) {
function Test_ActionsGetJobLogs_SingleJob (line 517) | func Test_ActionsGetJobLogs_SingleJob(t *testing.T) {
function Test_ActionsGetJobLogs_FailedJobs (line 555) | func Test_ActionsGetJobLogs_FailedJobs(t *testing.T) {
FILE: pkg/github/code_scanning.go
function GetCodeScanningAlert (line 19) | func GetCodeScanningAlert(t translations.TranslationHelperFunc) inventor...
function ListCodeScanningAlerts (line 96) | func ListCodeScanningAlerts(t translations.TranslationHelperFunc) invent...
FILE: pkg/github/code_scanning_test.go
function Test_GetCodeScanningAlert (line 17) | func Test_GetCodeScanningAlert(t *testing.T) {
function Test_ListCodeScanningAlerts (line 123) | func Test_ListCodeScanningAlerts(t *testing.T) {
FILE: pkg/github/context_tools.go
constant GetMeUIResourceURI (line 19) | GetMeUIResourceURI = "ui://github-mcp-server/get-me"
type UserDetails (line 23) | type UserDetails struct
function GetMe (line 44) | func GetMe(t translations.TranslationHelperFunc) inventory.ServerTool {
type TeamInfo (line 111) | type TeamInfo struct
type OrganizationTeams (line 117) | type OrganizationTeams struct
function GetTeams (line 122) | func GetTeams(t translations.TranslationHelperFunc) inventory.ServerTool {
function GetTeamMembers (line 220) | func GetTeamMembers(t translations.TranslationHelperFunc) inventory.Serv...
FILE: pkg/github/context_tools_test.go
function Test_GetMe (line 19) | func Test_GetMe(t *testing.T) {
function Test_GetTeams (line 141) | func Test_GetTeams(t *testing.T) {
function Test_GetTeamMembers (line 382) | func Test_GetTeamMembers(t *testing.T) {
FILE: pkg/github/copilot.go
type mvpDescription (line 28) | type mvpDescription struct
method String (line 34) | func (d *mvpDescription) String() string {
type linkedPullRequest (line 57) | type linkedPullRequest struct
type pollConfigKey (line 66) | type pollConfigKey struct
type PollConfig (line 69) | type PollConfig struct
function ContextWithPollConfig (line 76) | func ContextWithPollConfig(ctx context.Context, config PollConfig) conte...
function getPollConfig (line 81) | func getPollConfig(ctx context.Context) PollConfig {
function findLinkedCopilotPR (line 93) | func findLinkedCopilotPR(ctx context.Context, client *githubv4.Client, o...
function AssignCopilotToIssue (line 154) | func AssignCopilotToIssue(t translations.TranslationHelperFunc) inventor...
type ReplaceActorsForAssignableInput (line 438) | type ReplaceActorsForAssignableInput struct
type AgentAssignmentInput (line 444) | type AgentAssignmentInput struct
type UpdateIssueInput (line 452) | type UpdateIssueInput struct
function RequestCopilotReview (line 461) | func RequestCopilotReview(t translations.TranslationHelperFunc) inventor...
function AssignCodingAgentPrompt (line 547) | func AssignCodingAgentPrompt(t translations.TranslationHelperFunc) inven...
FILE: pkg/github/copilot_test.go
function TestAssignCopilotToIssue (line 20) | func TestAssignCopilotToIssue(t *testing.T) {
function Test_RequestCopilotReview (line 853) | func Test_RequestCopilotReview(t *testing.T) {
FILE: pkg/github/dependabot.go
function GetDependabotAlert (line 20) | func GetDependabotAlert(t translations.TranslationHelperFunc) inventory....
function ListDependabotAlerts (line 97) | func ListDependabotAlerts(t translations.TranslationHelperFunc) inventor...
FILE: pkg/github/dependabot_test.go
function Test_GetDependabotAlert (line 16) | func Test_GetDependabotAlert(t *testing.T) {
function Test_ListDependabotAlerts (line 112) | func Test_ListDependabotAlerts(t *testing.T) {
FILE: pkg/github/dependencies.go
type depsContextKey (line 25) | type depsContextKey struct
function InjectDepsMiddleware (line 30) | func InjectDepsMiddleware(deps ToolDependencies) mcp.Middleware {
function ContextWithDeps (line 44) | func ContextWithDeps(ctx context.Context, deps ToolDependencies) context...
function DepsFromContext (line 52) | func DepsFromContext(ctx context.Context) (ToolDependencies, bool) {
function MustDepsFromContext (line 59) | func MustDepsFromContext(ctx context.Context) ToolDependencies {
type ToolDependencies (line 73) | type ToolDependencies interface
type BaseDeps (line 102) | type BaseDeps struct
method GetClient (line 145) | func (d BaseDeps) GetClient(_ context.Context) (*gogithub.Client, erro...
method GetGQLClient (line 150) | func (d BaseDeps) GetGQLClient(_ context.Context) (*githubv4.Client, e...
method GetRawClient (line 155) | func (d BaseDeps) GetRawClient(_ context.Context) (*raw.Client, error) {
method GetRepoAccessCache (line 160) | func (d BaseDeps) GetRepoAccessCache(_ context.Context) (*lockdown.Rep...
method GetT (line 165) | func (d BaseDeps) GetT() translations.TranslationHelperFunc { return d...
method GetFlags (line 168) | func (d BaseDeps) GetFlags(_ context.Context) FeatureFlags { return d....
method GetContentWindowSize (line 171) | func (d BaseDeps) GetContentWindowSize() int { return d.ContentWindowS...
method IsFeatureEnabled (line 176) | func (d BaseDeps) IsFeatureEnabled(ctx context.Context, flagName strin...
function NewBaseDeps (line 122) | func NewBaseDeps(
function NewTool (line 201) | func NewTool[In, Out any](
function NewToolFromHandler (line 224) | func NewToolFromHandler(
type RequestDeps (line 239) | type RequestDeps struct
method GetClient (line 274) | func (d *RequestDeps) GetClient(ctx context.Context) (*gogithub.Client...
method GetGQLClient (line 300) | func (d *RequestDeps) GetGQLClient(ctx context.Context) (*githubv4.Cli...
method GetRawClient (line 331) | func (d *RequestDeps) GetRawClient(ctx context.Context) (*raw.Client, ...
method GetRepoAccessCache (line 348) | func (d *RequestDeps) GetRepoAccessCache(ctx context.Context) (*lockdo...
method GetT (line 364) | func (d *RequestDeps) GetT() translations.TranslationHelperFunc { retu...
method GetFlags (line 367) | func (d *RequestDeps) GetFlags(ctx context.Context) FeatureFlags {
method GetContentWindowSize (line 375) | func (d *RequestDeps) GetContentWindowSize() int { return d.ContentWin...
method IsFeatureEnabled (line 378) | func (d *RequestDeps) IsFeatureEnabled(ctx context.Context, flagName s...
function NewRequestDeps (line 253) | func NewRequestDeps(
FILE: pkg/github/dependencies_test.go
function TestIsFeatureEnabled_WithEnabledFlag (line 13) | func TestIsFeatureEnabled_WithEnabledFlag(t *testing.T) {
function TestIsFeatureEnabled_WithoutChecker (line 42) | func TestIsFeatureEnabled_WithoutChecker(t *testing.T) {
function TestIsFeatureEnabled_EmptyFlagName (line 62) | func TestIsFeatureEnabled_EmptyFlagName(t *testing.T) {
function TestIsFeatureEnabled_CheckerError (line 86) | func TestIsFeatureEnabled_CheckerError(t *testing.T) {
FILE: pkg/github/discussions.go
constant DefaultGraphQLPageSize (line 19) | DefaultGraphQLPageSize = 30
type DiscussionQueryResult (line 22) | type DiscussionQueryResult interface
type DiscussionFragment (line 43) | type DiscussionFragment struct
type NodeFragment (line 49) | type NodeFragment struct
type PageInfoFragment (line 66) | type PageInfoFragment struct
type BasicNoOrder (line 73) | type BasicNoOrder struct
method GetDiscussionFragment (line 27) | func (q *BasicNoOrder) GetDiscussionFragment() DiscussionFragment {
type BasicWithOrder (line 79) | type BasicWithOrder struct
method GetDiscussionFragment (line 31) | func (q *BasicWithOrder) GetDiscussionFragment() DiscussionFragment {
type WithCategoryAndOrder (line 85) | type WithCategoryAndOrder struct
method GetDiscussionFragment (line 35) | func (q *WithCategoryAndOrder) GetDiscussionFragment() DiscussionFragm...
type WithCategoryNoOrder (line 91) | type WithCategoryNoOrder struct
method GetDiscussionFragment (line 39) | func (q *WithCategoryNoOrder) GetDiscussionFragment() DiscussionFragme...
function fragmentToDiscussion (line 97) | func fragmentToDiscussion(fragment NodeFragment) *github.Discussion {
function getQueryType (line 113) | func getQueryType(useOrdering bool, categoryID *githubv4.ID) any {
function ListDiscussions (line 126) | func ListDiscussions(t translations.TranslationHelperFunc) inventory.Ser...
function GetDiscussion (line 279) | func GetDiscussion(t translations.TranslationHelperFunc) inventory.Serve...
function GetDiscussionComments (line 383) | func GetDiscussionComments(t translations.TranslationHelperFunc) invento...
function ListDiscussionCategories (line 510) | func ListDiscussionCategories(t translations.TranslationHelperFunc) inve...
FILE: pkg/github/discussions_test.go
function Test_ListDiscussions (line 215) | func Test_ListDiscussions(t *testing.T) {
function Test_GetDiscussion (line 496) | func Test_GetDiscussion(t *testing.T) {
function Test_GetDiscussionWithStringNumber (line 593) | func Test_GetDiscussionWithStringNumber(t *testing.T) {
function Test_GetDiscussionComments (line 637) | func Test_GetDiscussionComments(t *testing.T) {
function Test_GetDiscussionCommentsWithStringNumber (line 722) | func Test_GetDiscussionCommentsWithStringNumber(t *testing.T) {
function Test_ListDiscussionCategories (line 783) | func Test_ListDiscussionCategories(t *testing.T) {
FILE: pkg/github/dynamic_tools.go
type DynamicToolDependencies (line 18) | type DynamicToolDependencies struct
function NewDynamicTool (line 32) | func NewDynamicTool(toolset inventory.ToolsetMetadata, tool mcp.Tool, ha...
function toolsetIDsEnum (line 40) | func toolsetIDsEnum(r *inventory.Inventory) []any {
function DynamicTools (line 52) | func DynamicTools(r *inventory.Inventory) []inventory.ServerTool {
function EnableToolset (line 61) | func EnableToolset(r *inventory.Inventory) inventory.ServerTool {
function ListAvailableToolsets (line 116) | func ListAvailableToolsets() inventory.ServerTool {
function GetToolsetsTools (line 159) | func GetToolsetsTools(r *inventory.Inventory) inventory.ServerTool {
FILE: pkg/github/dynamic_tools_test.go
function createDynamicRequest (line 17) | func createDynamicRequest(args map[string]any) *mcp.CallToolRequest {
function TestDynamicTools_ListAvailableToolsets (line 26) | func TestDynamicTools_ListAvailableToolsets(t *testing.T) {
function TestDynamicTools_GetToolsetTools (line 75) | func TestDynamicTools_GetToolsetTools(t *testing.T) {
function TestDynamicTools_EnableToolset (line 125) | func TestDynamicTools_EnableToolset(t *testing.T) {
function TestDynamicTools_EnableToolset_InvalidToolset (line 174) | func TestDynamicTools_EnableToolset_InvalidToolset(t *testing.T) {
function TestDynamicTools_ToolsetsEnum (line 208) | func TestDynamicTools_ToolsetsEnum(t *testing.T) {
FILE: pkg/github/feature_flags.go
type FeatureFlags (line 4) | type FeatureFlags struct
FILE: pkg/github/feature_flags_test.go
constant RemoteMCPEnthusiasticGreeting (line 19) | RemoteMCPEnthusiasticGreeting = "remote_mcp_enthusiastic_greeting"
type FeatureChecker (line 22) | type FeatureChecker interface
function HelloWorldTool (line 29) | func HelloWorldTool(t translations.TranslationHelperFunc) inventory.Serv...
function TestHelloWorld_ConditionalBehavior_Featureflag (line 67) | func TestHelloWorld_ConditionalBehavior_Featureflag(t *testing.T) {
function TestHelloWorld_ConditionalBehavior_Config (line 138) | func TestHelloWorld_ConditionalBehavior_Config(t *testing.T) {
FILE: pkg/github/gists.go
function ListGists (line 21) | func ListGists(t translations.TranslationHelperFunc) inventory.ServerTool {
function GetGist (line 108) | func GetGist(t translations.TranslationHelperFunc) inventory.ServerTool {
function CreateGist (line 166) | func CreateGist(t translations.TranslationHelperFunc) inventory.ServerTo...
function UpdateGist (line 269) | func UpdateGist(t translations.TranslationHelperFunc) inventory.ServerTo...
FILE: pkg/github/gists_test.go
function Test_ListGists (line 18) | func Test_ListGists(t *testing.T) {
function Test_GetGist (line 186) | func Test_GetGist(t *testing.T) {
function Test_CreateGist (line 294) | func Test_CreateGist(t *testing.T) {
function Test_UpdateGist (line 432) | func Test_UpdateGist(t *testing.T) {
FILE: pkg/github/git.go
type TreeEntryResponse (line 20) | type TreeEntryResponse struct
type TreeResponse (line 30) | type TreeResponse struct
function GetRepositoryTree (line 42) | func GetRepositoryTree(t translations.TranslationHelperFunc) inventory.S...
FILE: pkg/github/git_test.go
function Test_GetRepositoryTree (line 18) | func Test_GetRepositoryTree(t *testing.T) {
FILE: pkg/github/helper_test.go
constant GetUser (line 23) | GetUser = "GET /user"
constant GetUserStarred (line 24) | GetUserStarred = "GET /user/starred"
constant GetUsersGistsByUsername (line 25) | GetUsersGistsByUsername = "GET /users/{username}/gists"
constant GetUsersStarredByUsername (line 26) | GetUsersStarredByUsername = "GET /users/{username}/starred"
constant PutUserStarredByOwnerByRepo (line 27) | PutUserStarredByOwnerByRepo = "PUT /user/starred/{owner}/{repo}"
constant DeleteUserStarredByOwnerByRepo (line 28) | DeleteUserStarredByOwnerByRepo = "DELETE /user/starred/{owner}/{repo}"
constant GetReposByOwnerByRepo (line 31) | GetReposByOwnerByRepo = "GET /repos/{owner}/{repo}"
constant GetReposBranchesByOwnerByRepo (line 32) | GetReposBranchesByOwnerByRepo = "GET /repos/{owner}/{repo}/branches"
constant GetReposTagsByOwnerByRepo (line 33) | GetReposTagsByOwnerByRepo = "GET /repos/{owner}/{repo}/tags"
constant GetReposCommitsByOwnerByRepo (line 34) | GetReposCommitsByOwnerByRepo = "GET /repos/{owner}/{repo}/commits"
constant GetReposCommitsByOwnerByRepoByRef (line 35) | GetReposCommitsByOwnerByRepoByRef = "GET /repos/{owner}/{repo}/commit...
constant GetReposContentsByOwnerByRepoByPath (line 36) | GetReposContentsByOwnerByRepoByPath = "GET /repos/{owner}/{repo}/conten...
constant PutReposContentsByOwnerByRepoByPath (line 37) | PutReposContentsByOwnerByRepoByPath = "PUT /repos/{owner}/{repo}/conten...
constant PostReposForksByOwnerByRepo (line 38) | PostReposForksByOwnerByRepo = "POST /repos/{owner}/{repo}/forks"
constant GetReposSubscriptionByOwnerByRepo (line 39) | GetReposSubscriptionByOwnerByRepo = "GET /repos/{owner}/{repo}/subscr...
constant PutReposSubscriptionByOwnerByRepo (line 40) | PutReposSubscriptionByOwnerByRepo = "PUT /repos/{owner}/{repo}/subscr...
constant DeleteReposSubscriptionByOwnerByRepo (line 41) | DeleteReposSubscriptionByOwnerByRepo = "DELETE /repos/{owner}/{repo}/sub...
constant GetReposGitTreesByOwnerByRepoByTree (line 44) | GetReposGitTreesByOwnerByRepoByTree = "GET /repos/{owner}/{repo}/...
constant GetReposGitRefByOwnerByRepoByRef (line 45) | GetReposGitRefByOwnerByRepoByRef = "GET /repos/{owner}/{repo}/...
constant PostReposGitRefsByOwnerByRepo (line 46) | PostReposGitRefsByOwnerByRepo = "POST /repos/{owner}/{repo}...
constant PatchReposGitRefsByOwnerByRepoByRef (line 47) | PatchReposGitRefsByOwnerByRepoByRef = "PATCH /repos/{owner}/{repo...
constant GetReposGitCommitsByOwnerByRepoByCommitSHA (line 48) | GetReposGitCommitsByOwnerByRepoByCommitSHA = "GET /repos/{owner}/{repo}/...
constant PostReposGitCommitsByOwnerByRepo (line 49) | PostReposGitCommitsByOwnerByRepo = "POST /repos/{owner}/{repo}...
constant GetReposGitTagsByOwnerByRepoByTagSHA (line 50) | GetReposGitTagsByOwnerByRepoByTagSHA = "GET /repos/{owner}/{repo}/...
constant PostReposGitTreesByOwnerByRepo (line 51) | PostReposGitTreesByOwnerByRepo = "POST /repos/{owner}/{repo}...
constant GetReposCommitsStatusByOwnerByRepoByRef (line 52) | GetReposCommitsStatusByOwnerByRepoByRef = "GET /repos/{owner}/{repo}/...
constant GetReposCommitsStatusesByOwnerByRepoByRef (line 53) | GetReposCommitsStatusesByOwnerByRepoByRef = "GET /repos/{owner}/{repo}/...
constant GetReposCommitsCheckRunsByOwnerByRepoByRef (line 54) | GetReposCommitsCheckRunsByOwnerByRepoByRef = "GET /repos/{owner}/{repo}/...
constant GetReposIssuesByOwnerByRepoByIssueNumber (line 57) | GetReposIssuesByOwnerByRepoByIssueNumber = "GET /repo...
constant GetReposIssuesCommentsByOwnerByRepoByIssueNumber (line 58) | GetReposIssuesCommentsByOwnerByRepoByIssueNumber = "GET /repo...
constant PostReposIssuesByOwnerByRepo (line 59) | PostReposIssuesByOwnerByRepo = "POST /rep...
constant PostReposIssuesCommentsByOwnerByRepoByIssueNumber (line 60) | PostReposIssuesCommentsByOwnerByRepoByIssueNumber = "POST /rep...
constant PatchReposIssuesByOwnerByRepoByIssueNumber (line 61) | PatchReposIssuesByOwnerByRepoByIssueNumber = "PATCH /re...
constant GetReposIssuesSubIssuesByOwnerByRepoByIssueNumber (line 62) | GetReposIssuesSubIssuesByOwnerByRepoByIssueNumber = "GET /repo...
constant PostReposIssuesSubIssuesByOwnerByRepoByIssueNumber (line 63) | PostReposIssuesSubIssuesByOwnerByRepoByIssueNumber = "POST /rep...
constant DeleteReposIssuesSubIssueByOwnerByRepoByIssueNumber (line 64) | DeleteReposIssuesSubIssueByOwnerByRepoByIssueNumber = "DELETE /r...
constant PatchReposIssuesSubIssuesPriorityByOwnerByRepoByIssueNumber (line 65) | PatchReposIssuesSubIssuesPriorityByOwnerByRepoByIssueNumber = "PATCH /re...
constant GetReposPullsByOwnerByRepo (line 68) | GetReposPullsByOwnerByRepo = "GET /repos/...
constant GetReposPullsByOwnerByRepoByPullNumber (line 69) | GetReposPullsByOwnerByRepoByPullNumber = "GET /repos/...
constant GetReposPullsFilesByOwnerByRepoByPullNumber (line 70) | GetReposPullsFilesByOwnerByRepoByPullNumber = "GET /repos/...
constant GetReposPullsReviewsByOwnerByRepoByPullNumber (line 71) | GetReposPullsReviewsByOwnerByRepoByPullNumber = "GET /repos/...
constant PostReposPullsByOwnerByRepo (line 72) | PostReposPullsByOwnerByRepo = "POST /repos...
constant PatchReposPullsByOwnerByRepoByPullNumber (line 73) | PatchReposPullsByOwnerByRepoByPullNumber = "PATCH /repo...
constant PutReposPullsMergeByOwnerByRepoByPullNumber (line 74) | PutReposPullsMergeByOwnerByRepoByPullNumber = "PUT /repos/...
constant PutReposPullsUpdateBranchByOwnerByRepoByPullNumber (line 75) | PutReposPullsUpdateBranchByOwnerByRepoByPullNumber = "PUT /repos/...
constant PostReposPullsRequestedReviewersByOwnerByRepoByPullNumber (line 76) | PostReposPullsRequestedReviewersByOwnerByRepoByPullNumber = "POST /repos...
constant PostReposPullsCommentsByOwnerByRepoByPullNumber (line 77) | PostReposPullsCommentsByOwnerByRepoByPullNumber = "POST /repos...
constant GetNotifications (line 80) | GetNotifications = "GET /notifications"
constant PutNotifications (line 81) | PutNotifications = "PUT /notifications"
constant GetReposNotificationsByOwnerByRepo (line 82) | GetReposNotificationsByOwnerByRepo = "GET /repos/{owner}/{...
constant PutReposNotificationsByOwnerByRepo (line 83) | PutReposNotificationsByOwnerByRepo = "PUT /repos/{owner}/{...
constant GetNotificationsThreadsByThreadID (line 84) | GetNotificationsThreadsByThreadID = "GET /notifications/t...
constant PatchNotificationsThreadsByThreadID (line 85) | PatchNotificationsThreadsByThreadID = "PATCH /notifications...
constant DeleteNotificationsThreadsByThreadID (line 86) | DeleteNotificationsThreadsByThreadID = "DELETE /notification...
constant PutNotificationsThreadsSubscriptionByThreadID (line 87) | PutNotificationsThreadsSubscriptionByThreadID = "PUT /notifications/t...
constant DeleteNotificationsThreadsSubscriptionByThreadID (line 88) | DeleteNotificationsThreadsSubscriptionByThreadID = "DELETE /notification...
constant GetGists (line 91) | GetGists = "GET /gists"
constant GetGistsByGistID (line 92) | GetGistsByGistID = "GET /gists/{gist_id}"
constant PostGists (line 93) | PostGists = "POST /gists"
constant PatchGistsByGistID (line 94) | PatchGistsByGistID = "PATCH /gists/{gist_id}"
constant GetReposReleasesByOwnerByRepo (line 97) | GetReposReleasesByOwnerByRepo = "GET /repos/{owner}/{repo}/rele...
constant GetReposReleasesLatestByOwnerByRepo (line 98) | GetReposReleasesLatestByOwnerByRepo = "GET /repos/{owner}/{repo}/rele...
constant GetReposReleasesTagsByOwnerByRepoByTag (line 99) | GetReposReleasesTagsByOwnerByRepoByTag = "GET /repos/{owner}/{repo}/rele...
constant GetReposCodeScanningAlertsByOwnerByRepo (line 102) | GetReposCodeScanningAlertsByOwnerByRepo = "GET /repos/{owne...
constant GetReposCodeScanningAlertsByOwnerByRepoByAlertNumber (line 103) | GetReposCodeScanningAlertsByOwnerByRepoByAlertNumber = "GET /repos/{owne...
constant GetReposSecretScanningAlertsByOwnerByRepo (line 106) | GetReposSecretScanningAlertsByOwnerByRepo = "GET /repos/{ow...
constant GetReposSecretScanningAlertsByOwnerByRepoByAlertNumber (line 107) | GetReposSecretScanningAlertsByOwnerByRepoByAlertNumber = "GET /repos/{ow...
constant GetReposDependabotAlertsByOwnerByRepo (line 110) | GetReposDependabotAlertsByOwnerByRepo = "GET /repos/{owner}...
constant GetReposDependabotAlertsByOwnerByRepoByAlertNumber (line 111) | GetReposDependabotAlertsByOwnerByRepoByAlertNumber = "GET /repos/{owner}...
constant GetAdvisories (line 114) | GetAdvisories = "GET /advisories"
constant GetAdvisoriesByGhsaID (line 115) | GetAdvisoriesByGhsaID = "GET /advisories/{ghsa_id}"
constant GetReposSecurityAdvisoriesByOwnerByRepo (line 116) | GetReposSecurityAdvisoriesByOwnerByRepo = "GET /repos/{owner}/{repo}/sec...
constant GetOrgsSecurityAdvisoriesByOrg (line 117) | GetOrgsSecurityAdvisoriesByOrg = "GET /orgs/{org}/security-advi...
constant GetReposActionsWorkflowsByOwnerByRepo (line 120) | GetReposActionsWorkflowsByOwnerByRepo = "GET /rep...
constant GetReposActionsWorkflowsByOwnerByRepoByWorkflowID (line 121) | GetReposActionsWorkflowsByOwnerByRepoByWorkflowID = "GET /rep...
constant PostReposActionsWorkflowsDispatchesByOwnerByRepoByWorkflowID (line 122) | PostReposActionsWorkflowsDispatchesByOwnerByRepoByWorkflowID = "POST /re...
constant GetReposActionsWorkflowsRunsByOwnerByRepoByWorkflowID (line 123) | GetReposActionsWorkflowsRunsByOwnerByRepoByWorkflowID = "GET /rep...
constant GetReposActionsRunsByOwnerByRepo (line 124) | GetReposActionsRunsByOwnerByRepo = "GET /rep...
constant GetReposActionsRunsByOwnerByRepoByRunID (line 125) | GetReposActionsRunsByOwnerByRepoByRunID = "GET /rep...
constant GetReposActionsRunsLogsByOwnerByRepoByRunID (line 126) | GetReposActionsRunsLogsByOwnerByRepoByRunID = "GET /rep...
constant GetReposActionsRunsJobsByOwnerByRepoByRunID (line 127) | GetReposActionsRunsJobsByOwnerByRepoByRunID = "GET /rep...
constant GetReposActionsRunsArtifactsByOwnerByRepoByRunID (line 128) | GetReposActionsRunsArtifactsByOwnerByRepoByRunID = "GET /rep...
constant GetReposActionsRunsTimingByOwnerByRepoByRunID (line 129) | GetReposActionsRunsTimingByOwnerByRepoByRunID = "GET /rep...
constant PostReposActionsRunsRerunByOwnerByRepoByRunID (line 130) | PostReposActionsRunsRerunByOwnerByRepoByRunID = "POST /re...
constant PostReposActionsRunsRerunFailedJobsByOwnerByRepoByRunID (line 131) | PostReposActionsRunsRerunFailedJobsByOwnerByRepoByRunID = "POST /re...
constant PostReposActionsRunsCancelByOwnerByRepoByRunID (line 132) | PostReposActionsRunsCancelByOwnerByRepoByRunID = "POST /re...
constant GetReposActionsJobsLogsByOwnerByRepoByJobID (line 133) | GetReposActionsJobsLogsByOwnerByRepoByJobID = "GET /rep...
constant DeleteReposActionsRunsLogsByOwnerByRepoByRunID (line 134) | DeleteReposActionsRunsLogsByOwnerByRepoByRunID = "DELETE /...
constant GetSearchCode (line 137) | GetSearchCode = "GET /search/code"
constant GetSearchIssues (line 138) | GetSearchIssues = "GET /search/issues"
constant GetSearchUsers (line 139) | GetSearchUsers = "GET /search/users"
constant GetSearchRepositories (line 140) | GetSearchRepositories = "GET /search/repositories"
constant GetRawReposContentsByOwnerByRepoByPath (line 144) | GetRawReposContentsByOwnerByRepoByPath = "GET /{owner}/{repo}/HE...
constant GetRawReposContentsByOwnerByRepoByBranchByPath (line 145) | GetRawReposContentsByOwnerByRepoByBranchByPath = "GET /{owner}/{repo}/re...
constant GetRawReposContentsByOwnerByRepoByTagByPath (line 146) | GetRawReposContentsByOwnerByRepoByTagByPath = "GET /{owner}/{repo}/re...
constant GetRawReposContentsByOwnerByRepoBySHAByPath (line 147) | GetRawReposContentsByOwnerByRepoBySHAByPath = "GET /{owner}/{repo}/{s...
constant GetOrgsProjectsV2 (line 151) | GetOrgsProjectsV2 = "GET /orgs/{org}/projectsV2"
constant GetOrgsProjectsV2ByProject (line 152) | GetOrgsProjectsV2ByProject = "GET /orgs/{org}/projectsV2...
constant GetOrgsProjectsV2FieldsByProject (line 153) | GetOrgsProjectsV2FieldsByProject = "GET /orgs/{org}/projectsV2...
constant GetOrgsProjectsV2FieldsByProjectByFieldID (line 154) | GetOrgsProjectsV2FieldsByProjectByFieldID = "GET /orgs/{org}/projectsV2...
constant GetOrgsProjectsV2ItemsByProject (line 155) | GetOrgsProjectsV2ItemsByProject = "GET /orgs/{org}/projectsV2...
constant GetOrgsProjectsV2ItemsByProjectByItemID (line 156) | GetOrgsProjectsV2ItemsByProjectByItemID = "GET /orgs/{org}/projectsV2...
constant PostOrgsProjectsV2ItemsByProject (line 157) | PostOrgsProjectsV2ItemsByProject = "POST /orgs/{org}/projectsV...
constant PatchOrgsProjectsV2ItemsByProjectByItemID (line 158) | PatchOrgsProjectsV2ItemsByProjectByItemID = "PATCH /orgs/{org}/projects...
constant DeleteOrgsProjectsV2ItemsByProjectByItemID (line 159) | DeleteOrgsProjectsV2ItemsByProjectByItemID = "DELETE /orgs/{org}/project...
constant GetUsersProjectsV2ByUsername (line 161) | GetUsersProjectsV2ByUsername = "GET /users/{use...
constant GetUsersProjectsV2ByUsernameByProject (line 162) | GetUsersProjectsV2ByUsernameByProject = "GET /users/{use...
constant GetUsersProjectsV2FieldsByUsernameByProject (line 163) | GetUsersProjectsV2FieldsByUsernameByProject = "GET /users/{use...
constant GetUsersProjectsV2FieldsByUsernameByProjectByFieldID (line 164) | GetUsersProjectsV2FieldsByUsernameByProjectByFieldID = "GET /users/{use...
constant GetUsersProjectsV2ItemsByUsernameByProject (line 165) | GetUsersProjectsV2ItemsByUsernameByProject = "GET /users/{use...
constant GetUsersProjectsV2ItemsByUsernameByProjectByItemID (line 166) | GetUsersProjectsV2ItemsByUsernameByProjectByItemID = "GET /users/{use...
constant PostUsersProjectsV2ItemsByUsernameByProject (line 167) | PostUsersProjectsV2ItemsByUsernameByProject = "POST /users/{us...
constant PatchUsersProjectsV2ItemsByUsernameByProjectByItemID (line 168) | PatchUsersProjectsV2ItemsByUsernameByProjectByItemID = "PATCH /users/{u...
constant DeleteUsersProjectsV2ItemsByUsernameByProjectByItemID (line 169) | DeleteUsersProjectsV2ItemsByUsernameByProjectByItemID = "DELETE /users/{...
constant GetOrgsIssueTypesByOrg (line 172) | GetOrgsIssueTypesByOrg = "GET /orgs/{org}/issue-types"
type expectations (line 175) | type expectations struct
function expect (line 183) | func expect(t *testing.T, e expectations) *partialMock {
function expectPath (line 194) | func expectPath(t *testing.T, expectedPath string) *partialMock {
function expectQueryParams (line 203) | func expectQueryParams(t *testing.T, expectedQueryParams map[string]stri...
function expectRequestBody (line 212) | func expectRequestBody(t *testing.T, expectedRequestBody any) *partialMo...
type partialMock (line 219) | type partialMock struct
method andThen (line 227) | func (p *partialMock) andThen(responseHandler http.HandlerFunc) http.H...
function mockResponse (line 255) | func mockResponse(t *testing.T, code int, body any) http.HandlerFunc {
function createMCPRequest (line 274) | func createMCPRequest(args any) mcp.CallToolRequest {
constant ClientNameVSCodeInsiders (line 297) | ClientNameVSCodeInsiders = "Visual Studio Code - Insiders"
constant ClientNameVSCode (line 298) | ClientNameVSCode = "Visual Studio Code"
function createMCPRequestWithSession (line 304) | func createMCPRequestWithSession(t *testing.T, clientName string, withUI...
function getTextResult (line 348) | func getTextResult(t *testing.T, result *mcp.CallToolResult) *mcp.TextCo...
function getErrorResult (line 357) | func getErrorResult(t *testing.T, result *mcp.CallToolResult) *mcp.TextC...
function TestOptionalParamOK (line 367) | func TestOptionalParamOK(t *testing.T) {
function getResourceResult (line 477) | func getResourceResult(t *testing.T, result *mcp.CallToolResult) *mcp.Re...
type MockRoundTripper (line 491) | type MockRoundTripper struct
method RoundTrip (line 504) | func (m *MockRoundTripper) RoundTrip(req *http.Request) (*http.Respons...
method OnRequest (line 534) | func (m *MockRoundTripper) OnRequest(method, path string, handler http...
function NewMockRoundTripper (line 497) | func NewMockRoundTripper() *MockRoundTripper {
function NewMockHTTPClient (line 541) | func NewMockHTTPClient() (*http.Client, *MockRoundTripper) {
type responseRecorder (line 548) | type responseRecorder struct
method Header (line 554) | func (r *responseRecorder) Header() http.Header {
method Write (line 558) | func (r *responseRecorder) Write(data []byte) (int, error) {
method WriteHeader (line 565) | func (r *responseRecorder) WriteHeader(statusCode int) {
function matchPath (line 570) | func matchPath(pattern, path string) bool {
function executeHandler (line 619) | func executeHandler(handler http.HandlerFunc, req *http.Request) *http.R...
function MockHTTPClientWithHandler (line 635) | func MockHTTPClientWithHandler(handler http.HandlerFunc) *http.Client {
function MockHTTPClientWithHandlers (line 643) | func MockHTTPClientWithHandlers(handlers map[string]http.HandlerFunc) *h...
type EndpointPattern (line 649) | type EndpointPattern
type MockBackendOption (line 651) | type MockBackendOption
function parseEndpointPattern (line 653) | func parseEndpointPattern(p EndpointPattern) (string, string) {
function WithRequestMatch (line 661) | func WithRequestMatch(pattern EndpointPattern, response any) MockBackend...
function WithRequestMatchHandler (line 681) | func WithRequestMatchHandler(pattern EndpointPattern, handler http.Handl...
function NewMockedHTTPClient (line 688) | func NewMockedHTTPClient(options ...MockBackendOption) *http.Client {
function MustMarshal (line 698) | func MustMarshal(v any) []byte {
type multiHandlerTransport (line 706) | type multiHandlerTransport struct
method RoundTrip (line 710) | func (m *multiHandlerTransport) RoundTrip(req *http.Request) (*http.Re...
function extractPathParams (line 772) | func extractPathParams(pattern, path string) map[string]string {
function ParseRequestPath (line 792) | func ParseRequestPath(t *testing.T, req *http.Request, pattern string) u...
FILE: pkg/github/inventory.go
function NewInventory (line 13) | func NewInventory(t translations.TranslationHelperFunc) *inventory.Build...
FILE: pkg/github/issues.go
type CloseIssueInput (line 26) | type CloseIssueInput struct
type IssueClosedStateReason (line 35) | type IssueClosedStateReason
constant IssueClosedStateReasonCompleted (line 38) | IssueClosedStateReasonCompleted IssueClosedStateReason = "COMPLETED"
constant IssueClosedStateReasonDuplicate (line 39) | IssueClosedStateReasonDuplicate IssueClosedStateReason = "DUPLICATE"
constant IssueClosedStateReasonNotPlanned (line 40) | IssueClosedStateReasonNotPlanned IssueClosedStateReason = "NOT_PLANNED"
function fetchIssueIDs (line 46) | func fetchIssueIDs(ctx context.Context, gqlClient *githubv4.Client, owne...
function getCloseStateReason (line 94) | func getCloseStateReason(stateReason string) IssueClosedStateReason {
type IssueFragment (line 106) | type IssueFragment struct
type IssueQueryResult (line 131) | type IssueQueryResult interface
type IssueQueryFragment (line 135) | type IssueQueryFragment struct
type ListIssuesQuery (line 147) | type ListIssuesQuery struct
method GetIssueFragment (line 179) | func (q *ListIssuesQuery) GetIssueFragment() IssueQueryFragment {
type ListIssuesQueryTypeWithLabels (line 154) | type ListIssuesQueryTypeWithLabels struct
method GetIssueFragment (line 175) | func (q *ListIssuesQueryTypeWithLabels) GetIssueFragment() IssueQueryF...
type ListIssuesQueryWithSince (line 161) | type ListIssuesQueryWithSince struct
method GetIssueFragment (line 183) | func (q *ListIssuesQueryWithSince) GetIssueFragment() IssueQueryFragme...
type ListIssuesQueryTypeWithLabelsWithSince (line 168) | type ListIssuesQueryTypeWithLabelsWithSince struct
method GetIssueFragment (line 187) | func (q *ListIssuesQueryTypeWithLabelsWithSince) GetIssueFragment() Is...
function getIssueQueryType (line 191) | func getIssueQueryType(hasLabels bool, hasSince bool) any {
function IssueRead (line 205) | func IssueRead(t translations.TranslationHelperFunc) inventory.ServerTool {
function GetIssue (line 302) | func GetIssue(ctx context.Context, client *github.Client, deps ToolDepen...
function GetIssueComments (line 354) | func GetIssueComments(ctx context.Context, client *github.Client, deps T...
function GetSubIssues (line 414) | func GetSubIssues(ctx context.Context, client *github.Client, deps ToolD...
function GetIssueLabels (line 480) | func GetIssueLabels(ctx context.Context, client *githubv4.Client, owner ...
function ListIssueTypes (line 534) | func ListIssueTypes(t translations.TranslationHelperFunc) inventory.Serv...
function AddIssueComment (line 590) | func AddIssueComment(t translations.TranslationHelperFunc) inventory.Ser...
function SubIssueWrite (line 679) | func SubIssueWrite(t translations.TranslationHelperFunc) inventory.Serve...
function AddSubIssue (line 792) | func AddSubIssue(ctx context.Context, client *github.Client, owner strin...
function RemoveSubIssue (line 826) | func RemoveSubIssue(ctx context.Context, client *github.Client, owner st...
function ReprioritizeSubIssue (line 857) | func ReprioritizeSubIssue(ctx context.Context, client *github.Client, ow...
function SearchIssues (line 907) | func SearchIssues(t translations.TranslationHelperFunc) inventory.Server...
constant IssueWriteUIResourceURI (line 970) | IssueWriteUIResourceURI = "ui://github-mcp-server/issue-write"
function IssueWrite (line 972) | func IssueWrite(t translations.TranslationHelperFunc) inventory.ServerTo...
function CreateIssue (line 1184) | func CreateIssue(ctx context.Context, client *github.Client, owner strin...
function UpdateIssue (line 1237) | func UpdateIssue(ctx context.Context, client *github.Client, gqlClient *...
function ListIssues (line 1363) | func ListIssues(t translations.TranslationHelperFunc) inventory.ServerTo...
function parseISOTimestamp (line 1578) | func parseISOTimestamp(timestamp string) (time.Time, error) {
FILE: pkg/github/issues_test.go
type repoAccessKey (line 28) | type repoAccessKey struct
type repoAccessValue (line 34) | type repoAccessValue struct
type repoAccessMockTransport (line 39) | type repoAccessMockTransport struct
method RoundTrip (line 52) | func (rt *repoAccessMockTransport) RoundTrip(req *http.Request) (*http...
function newRepoAccessHTTPClient (line 43) | func newRepoAccessHTTPClient() *http.Client {
function toString (line 109) | func toString(v any) string {
function Test_GetIssue (line 122) | func Test_GetIssue(t *testing.T) {
function Test_AddIssueComment (line 361) | func Test_AddIssueComment(t *testing.T) {
function Test_SearchIssues (line 472) | func Test_SearchIssues(t *testing.T) {
function Test_CreateIssue (line 779) | func Test_CreateIssue(t *testing.T) {
function Test_IssueWrite_InsidersMode_UIGate (line 937) | func Test_IssueWrite_InsidersMode_UIGate(t *testing.T) {
function Test_ListIssues (line 1111) | func Test_ListIssues(t *testing.T) {
function Test_UpdateIssue (line 1435) | func Test_UpdateIssue(t *testing.T) {
function Test_ParseISOTimestamp (line 1911) | func Test_ParseISOTimestamp(t *testing.T) {
function Test_GetIssueComments (line 1961) | func Test_GetIssueComments(t *testing.T) {
function Test_GetIssueLabels (line 2143) | func Test_GetIssueLabels(t *testing.T) {
function Test_AddSubIssue (line 2250) | func Test_AddSubIssue(t *testing.T) {
function Test_GetSubIssues (line 2474) | func Test_GetSubIssues(t *testing.T) {
function Test_RemoveSubIssue (line 2708) | func Test_RemoveSubIssue(t *testing.T) {
function Test_ReprioritizeSubIssue (line 2914) | func Test_ReprioritizeSubIssue(t *testing.T) {
function Test_ListIssueTypes (line 3174) | func Test_ListIssueTypes(t *testing.T) {
FILE: pkg/github/labels.go
function GetLabel (line 20) | func GetLabel(t translations.TranslationHelperFunc) inventory.ServerTool {
function GetLabelForLabelsToolset (line 115) | func GetLabelForLabelsToolset(t translations.TranslationHelperFunc) inve...
function ListLabels (line 122) | func ListLabels(t translations.TranslationHelperFunc) inventory.ServerTo...
function LabelWrite (line 213) | func LabelWrite(t translations.TranslationHelperFunc) inventory.ServerTo...
function getRepositoryID (line 405) | func getRepositoryID(ctx context.Context, client *githubv4.Client, owner...
function getLabelID (line 422) | func getLabelID(ctx context.Context, client *githubv4.Client, owner, rep...
FILE: pkg/github/labels_test.go
function TestGetLabel (line 16) | func TestGetLabel(t *testing.T) {
function TestListLabels (line 141) | func TestListLabels(t *testing.T) {
function TestWriteLabel (line 239) | func TestWriteLabel(t *testing.T) {
FILE: pkg/github/minimal_types.go
type MinimalUser (line 12) | type MinimalUser struct
type MinimalSearchUsersResult (line 21) | type MinimalSearchUsersResult struct
type MinimalRepository (line 28) | type MinimalRepository struct
type MinimalSearchRepositoriesResult (line 48) | type MinimalSearchRepositoriesResult struct
type MinimalCommitAuthor (line 55) | type MinimalCommitAuthor struct
type MinimalCommitInfo (line 62) | type MinimalCommitInfo struct
type MinimalCommitStats (line 69) | type MinimalCommitStats struct
type MinimalCommitFile (line 76) | type MinimalCommitFile struct
type MinimalPRFile (line 86) | type MinimalPRFile struct
type MinimalCommit (line 97) | type MinimalCommit struct
type MinimalRelease (line 108) | type MinimalRelease struct
type MinimalBranch (line 121) | type MinimalBranch struct
type MinimalTag (line 128) | type MinimalTag struct
type MinimalResponse (line 136) | type MinimalResponse struct
type MinimalProject (line 141) | type MinimalProject struct
type MinimalReactions (line 160) | type MinimalReactions struct
type MinimalIssue (line 173) | type MinimalIssue struct
type MinimalIssuesResponse (line 197) | type MinimalIssuesResponse struct
type MinimalIssueComment (line 204) | type MinimalIssueComment struct
type MinimalFileContentResponse (line 216) | type MinimalFileContentResponse struct
type MinimalFileContent (line 222) | type MinimalFileContent struct
type MinimalFileCommit (line 231) | type MinimalFileCommit struct
type MinimalPullRequest (line 239) | type MinimalPullRequest struct
type MinimalPRBranch (line 268) | type MinimalPRBranch struct
type MinimalPRBranchRepo (line 275) | type MinimalPRBranchRepo struct
type MinimalProjectStatusUpdate (line 280) | type MinimalProjectStatusUpdate struct
type MinimalPullRequestReview (line 291) | type MinimalPullRequestReview struct
function convertToMinimalPullRequestReview (line 304) | func convertToMinimalPullRequestReview(review *github.PullRequestReview)...
function convertToMinimalIssue (line 322) | func convertToMinimalIssue(issue *github.Issue) MinimalIssue {
function fragmentToMinimalIssue (line 388) | func fragmentToMinimalIssue(fragment IssueFragment) MinimalIssue {
function convertToMinimalIssuesResponse (line 409) | func convertToMinimalIssuesResponse(fragment IssueQueryFragment) Minimal...
function convertToMinimalIssueComment (line 427) | func convertToMinimalIssueComment(comment *github.IssueComment) MinimalI...
function convertToMinimalFileContentResponse (line 460) | func convertToMinimalFileContentResponse(resp *github.RepositoryContentR...
function convertToMinimalPullRequest (line 496) | func convertToMinimalPullRequest(pr *github.PullRequest) MinimalPullRequ...
function convertToMinimalPRBranch (line 564) | func convertToMinimalPRBranch(branch *github.PullRequestBranch) *Minimal...
function convertToMinimalProject (line 584) | func convertToMinimalProject(fullProject *github.ProjectV2) *MinimalProj...
function convertToMinimalUser (line 607) | func convertToMinimalUser(user *github.User) *MinimalUser {
function convertToMinimalCommit (line 621) | func convertToMinimalCommit(commit *github.RepositoryCommit, includeDiff...
type MinimalPageInfo (line 700) | type MinimalPageInfo struct
type MinimalReviewComment (line 708) | type MinimalReviewComment struct
type MinimalReviewThread (line 719) | type MinimalReviewThread struct
type MinimalReviewThreadsResponse (line 728) | type MinimalReviewThreadsResponse struct
function convertToMinimalPRFiles (line 734) | func convertToMinimalPRFiles(files []*github.CommitFile) []MinimalPRFile {
function convertToMinimalBranch (line 751) | func convertToMinimalBranch(branch *github.Branch) MinimalBranch {
function convertToMinimalRelease (line 759) | func convertToMinimalRelease(release *github.RepositoryRelease) MinimalR...
function convertToMinimalTag (line 778) | func convertToMinimalTag(tag *github.RepositoryTag) MinimalTag {
type MinimalCheckRun (line 791) | type MinimalCheckRun struct
type MinimalCheckRunsResult (line 803) | type MinimalCheckRunsResult struct
function convertToMinimalCheckRun (line 809) | func convertToMinimalCheckRun(checkRun *github.CheckRun) MinimalCheckRun {
function convertToMinimalReviewThreadsResponse (line 829) | func convertToMinimalReviewThreadsResponse(query reviewThreadsQuery) Min...
function convertToMinimalReviewThread (line 849) | func convertToMinimalReviewThread(thread reviewThreadNode) MinimalReview...
function convertToMinimalReviewComment (line 864) | func convertToMinimalReviewComment(c reviewCommentNode) MinimalReviewCom...
FILE: pkg/github/notifications.go
constant FilterDefault (line 23) | FilterDefault = "default"
constant FilterIncludeRead (line 24) | FilterIncludeRead = "include_read_notifications"
constant FilterOnlyParticipating (line 25) | FilterOnlyParticipating = "only_participating"
function ListNotifications (line 29) | func ListNotifications(t translations.TranslationHelperFunc) inventory.S...
function DismissNotification (line 166) | func DismissNotification(t translations.TranslationHelperFunc) inventory...
function MarkAllNotificationsRead (line 248) | func MarkAllNotificationsRead(t translations.TranslationHelperFunc) inve...
function GetNotificationDetails (line 340) | func GetNotificationDetails(t translations.TranslationHelperFunc) invent...
constant NotificationActionIgnore (line 403) | NotificationActionIgnore = "ignore"
constant NotificationActionWatch (line 404) | NotificationActionWatch = "watch"
constant NotificationActionDelete (line 405) | NotificationActionDelete = "delete"
function ManageNotificationSubscription (line 409) | func ManageNotificationSubscription(t translations.TranslationHelperFunc...
constant RepositorySubscriptionActionWatch (line 499) | RepositorySubscriptionActionWatch = "watch"
constant RepositorySubscriptionActionIgnore (line 500) | RepositorySubscriptionActionIgnore = "ignore"
constant RepositorySubscriptionActionDelete (line 501) | RepositorySubscriptionActionDelete = "delete"
function ManageRepositoryNotificationSubscription (line 505) | func ManageRepositoryNotificationSubscription(t translations.Translation...
FILE: pkg/github/notifications_test.go
function Test_ListNotifications (line 17) | func Test_ListNotifications(t *testing.T) {
function Test_ManageNotificationSubscription (line 141) | func Test_ManageNotificationSubscription(t *testing.T) {
function Test_ManageRepositoryNotificationSubscription (line 277) | func Test_ManageRepositoryNotificationSubscription(t *testing.T) {
function Test_DismissNotification (line 437) | func Test_DismissNotification(t *testing.T) {
function Test_MarkAllNotificationsRead (line 581) | func Test_MarkAllNotificationsRead(t *testing.T) {
function Test_GetNotificationDetails (line 678) | func Test_GetNotificationDetails(t *testing.T) {
FILE: pkg/github/params.go
function OptionalParamOK (line 15) | func OptionalParamOK[T any, A map[string]any](args A, p string) (value T...
function isAcceptedError (line 38) | func isAcceptedError(err error) bool {
function toInt (line 46) | func toInt(val any) (int, error) {
function toInt64 (line 75) | func toInt64(val any) (int64, error) {
function RequiredParam (line 108) | func RequiredParam[T comparable](args map[string]any, p string) (T, erro...
function RequiredInt (line 134) | func RequiredInt(args map[string]any, p string) (int, error) {
function RequiredBigInt (line 158) | func RequiredBigInt(args map[string]any, p string) (int64, error) {
function OptionalParam (line 180) | func OptionalParam[T any](args map[string]any, p string) (T, error) {
function OptionalIntParam (line 200) | func OptionalIntParam(args map[string]any, p string) (int, error) {
function OptionalIntParamWithDefault (line 216) | func OptionalIntParamWithDefault(args map[string]any, p string, d int) (...
function OptionalBoolParamWithDefault (line 229) | func OptionalBoolParamWithDefault(args map[string]any, p string, d bool)...
function OptionalStringArrayParam (line 245) | func OptionalStringArrayParam(args map[string]any, p string) ([]string, ...
function convertStringSliceToBigIntSlice (line 271) | func convertStringSliceToBigIntSlice(s []string) ([]int64, error) {
function convertStringToBigInt (line 283) | func convertStringToBigInt(s string, def int64) (int64, error) {
function OptionalBigIntArrayParam (line 295) | func OptionalBigIntArrayParam(args map[string]any, p string) ([]int64, e...
function WithPagination (line 327) | func WithPagination(schema *jsonschema.Schema) *jsonschema.Schema {
function WithUnifiedPagination (line 346) | func WithUnifiedPagination(schema *jsonschema.Schema) *jsonschema.Schema {
function WithCursorPagination (line 369) | func WithCursorPagination(schema *jsonschema.Schema) *jsonschema.Schema {
type PaginationParams (line 385) | type PaginationParams struct
method ToGraphQLParams (line 467) | func (p PaginationParams) ToGraphQLParams() (*GraphQLPaginationParams,...
function OptionalPaginationParams (line 396) | func OptionalPaginationParams(args map[string]any) (PaginationParams, er...
function OptionalCursorPaginationParams (line 418) | func OptionalCursorPaginationParams(args map[string]any) (CursorPaginati...
type CursorPaginationParams (line 433) | type CursorPaginationParams struct
method ToGraphQLParams (line 439) | func (p CursorPaginationParams) ToGraphQLParams() (*GraphQLPaginationP...
type GraphQLPaginationParams (line 459) | type GraphQLPaginationParams struct
FILE: pkg/github/params_test.go
function Test_IsAcceptedError (line 12) | func Test_IsAcceptedError(t *testing.T) {
function Test_RequiredStringParam (line 48) | func Test_RequiredStringParam(t *testing.T) {
function Test_OptionalStringParam (line 100) | func Test_OptionalStringParam(t *testing.T) {
function Test_RequiredInt (line 152) | func Test_RequiredInt(t *testing.T) {
function Test_OptionalIntParam (line 273) | func Test_OptionalIntParam(t *testing.T) {
function Test_OptionalNumberParamWithDefault (line 360) | func Test_OptionalNumberParamWithDefault(t *testing.T) {
function Test_OptionalBooleanParam (line 433) | func Test_OptionalBooleanParam(t *testing.T) {
function TestOptionalStringArrayParam (line 485) | func TestOptionalStringArrayParam(t *testing.T) {
function TestOptionalPaginationParams (line 552) | func TestOptionalPaginationParams(t *testing.T) {
FILE: pkg/github/projects.go
constant ProjectUpdateFailedError (line 23) | ProjectUpdateFailedError = "failed to update a project item"
constant ProjectAddFailedError (line 24) | ProjectAddFailedError = "failed to add a project item"
constant ProjectDeleteFailedError (line 25) | ProjectDeleteFailedError = "failed to delete a project item"
constant ProjectListFailedError (line 26) | ProjectListFailedError = "failed to list project items"
constant ProjectStatusUpdateListFailedError (line 27) | ProjectStatusUpdateListFailedError = "failed to list project status up...
constant ProjectStatusUpdateGetFailedError (line 28) | ProjectStatusUpdateGetFailedError = "failed to get project status upd...
constant ProjectStatusUpdateCreateFailedError (line 29) | ProjectStatusUpdateCreateFailedError = "failed to create project status ...
constant ProjectResolveIDFailedError (line 30) | ProjectResolveIDFailedError = "failed to resolve project ID"
constant MaxProjectsPerPage (line 31) | MaxProjectsPerPage = 50
constant projectsMethodListProjects (line 36) | projectsMethodListProjects = "list_projects"
constant projectsMethodListProjectFields (line 37) | projectsMethodListProjectFields = "list_project_fields"
constant projectsMethodListProjectItems (line 38) | projectsMethodListProjectItems = "list_project_items"
constant projectsMethodGetProject (line 39) | projectsMethodGetProject = "get_project"
constant projectsMethodGetProjectField (line 40) | projectsMethodGetProjectField = "get_project_field"
constant projectsMethodGetProjectItem (line 41) | projectsMethodGetProjectItem = "get_project_item"
constant projectsMethodAddProjectItem (line 42) | projectsMethodAddProjectItem = "add_project_item"
constant projectsMethodUpdateProjectItem (line 43) | projectsMethodUpdateProjectItem = "update_project_item"
constant projectsMethodDeleteProjectItem (line 44) | projectsMethodDeleteProjectItem = "delete_project_item"
constant projectsMethodListProjectStatusUpdates (line 45) | projectsMethodListProjectStatusUpdates = "list_project_status_updates"
constant projectsMethodGetProjectStatusUpdate (line 46) | projectsMethodGetProjectStatusUpdate = "get_project_status_update"
constant projectsMethodCreateProjectStatusUpdate (line 47) | projectsMethodCreateProjectStatusUpdate = "create_project_status_update"
type statusUpdateNode (line 52) | type statusUpdateNode struct
type statusUpdateConnection (line 64) | type statusUpdateConnection struct
type statusUpdatesUserQuery (line 70) | type statusUpdatesUserQuery struct
type statusUpdatesOrgQuery (line 79) | type statusUpdatesOrgQuery struct
type statusUpdateNodeQuery (line 88) | type statusUpdateNodeQuery struct
type CreateProjectV2StatusUpdateInput (line 96) | type CreateProjectV2StatusUpdateInput struct
function convertToMinimalStatusUpdate (line 114) | func convertToMinimalStatusUpdate(node statusUpdateNode) MinimalProjectS...
function derefString (line 131) | func derefString(s *githubv4.String) string {
function ProjectsList (line 139) | func ProjectsList(t translations.TranslationHelperFunc) inventory.Server...
function ProjectsGet (line 264) | func ProjectsGet(t translations.TranslationHelperFunc) inventory.ServerT...
function ProjectsWrite (line 401) | func ProjectsWrite(t translations.TranslationHelperFunc) inventory.Serve...
function listProjects (line 608) | func listProjects(ctx context.Context, client *github.Client, args map[s...
function listProjectsFromBothOwnerTypes (line 685) | func listProjectsFromBothOwnerTypes(ctx context.Context, client *github....
function listProjectFields (line 735) | func listProjectFields(ctx context.Context, client *github.Client, args ...
function listProjectItems (line 781) | func listProjectItems(ctx context.Context, client *github.Client, args m...
function getProject (line 846) | func getProject(ctx context.Context, client *github.Client, owner, owner...
function getProjectField (line 882) | func getProjectField(ctx context.Context, client *github.Client, owner, ...
function getProjectItem (line 917) | func getProjectItem(ctx context.Context, client *github.Client, owner, o...
function updateProjectItem (line 960) | func updateProjectItem(ctx context.Context, client *github.Client, owner...
function deleteProjectItem (line 999) | func deleteProjectItem(ctx context.Context, client *github.Client, owner...
function resolveProjectNodeID (line 1029) | func resolveProjectNodeID(ctx context.Context, gqlClient *githubv4.Clien...
function addProjectItem (line 1066) | func addProjectItem(ctx context.Context, gqlClient *githubv4.Client, own...
function validateDateFormat (line 1123) | func validateDateFormat(value, fieldName string) error {
function createProjectStatusUpdate (line 1131) | func createProjectStatusUpdate(ctx context.Context, gqlClient *githubv4....
function listProjectStatusUpdates (line 1202) | func listProjectStatusUpdates(ctx context.Context, gqlClient *githubv4.C...
function getProjectStatusUpdate (line 1281) | func getProjectStatusUpdate(ctx context.Context, gqlClient *githubv4.Cli...
type pageInfo (line 1304) | type pageInfo struct
function validateAndConvertToInt64 (line 1312) | func validateAndConvertToInt64(value any) (int64, error) {
function buildUpdateProjectItem (line 1331) | func buildUpdateProjectItem(input map[string]any) (*github.UpdateProject...
function buildPageInfo (line 1361) | func buildPageInfo(resp *github.Response) pageInfo {
function extractPaginationOptionsFromArgs (line 1370) | func extractPaginationOptionsFromArgs(args map[string]any) (github.ListP...
function resolveIssueNodeID (line 1406) | func resolveIssueNodeID(ctx context.Context, gqlClient *githubv4.Client,...
function resolvePullRequestNodeID (line 1430) | func resolvePullRequestNodeID(ctx context.Context, gqlClient *githubv4.C...
function detectOwnerType (line 1455) | func detectOwnerType(ctx context.Context, client *github.Client, owner s...
FILE: pkg/github/projects_test.go
function Test_ProjectsList (line 21) | func Test_ProjectsList(t *testing.T) {
function Test_ProjectsList_ListProjects (line 38) | func Test_ProjectsList_ListProjects(t *testing.T) {
function Test_ProjectsList_ListProjectFields (line 133) | func Test_ProjectsList_ListProjectFields(t *testing.T) {
function Test_ProjectsList_ListProjectItems (line 189) | func Test_ProjectsList_ListProjectItems(t *testing.T) {
function Test_ProjectsGet (line 225) | func Test_ProjectsGet(t *testing.T) {
function Test_ProjectsGet_GetProject (line 242) | func Test_ProjectsGet_GetProject(t *testing.T) {
function Test_ProjectsGet_GetProjectField (line 297) | func Test_ProjectsGet_GetProjectField(t *testing.T) {
function Test_ProjectsGet_GetProjectItem (line 353) | func Test_ProjectsGet_GetProjectItem(t *testing.T) {
function Test_ProjectsWrite (line 409) | func Test_ProjectsWrite(t *testing.T) {
function Test_ProjectsWrite_AddProjectItem (line 436) | func Test_ProjectsWrite_AddProjectItem(t *testing.T) {
function Test_ProjectsWrite_UpdateProjectItem (line 704) | func Test_ProjectsWrite_UpdateProjectItem(t *testing.T) {
function Test_ProjectsWrite_DeleteProjectItem (line 765) | func Test_ProjectsWrite_DeleteProjectItem(t *testing.T) {
function Test_ProjectsList_ListProjectStatusUpdates (line 818) | func Test_ProjectsList_ListProjectStatusUpdates(t *testing.T) {
function Test_ProjectsGet_GetProjectStatusUpdate (line 891) | func Test_ProjectsGet_GetProjectStatusUpdate(t *testing.T) {
function Test_ProjectsWrite_CreateProjectStatusUpdate (line 940) | func Test_ProjectsWrite_CreateProjectStatusUpdate(t *testing.T) {
FILE: pkg/github/prompts.go
function AllPrompts (line 10) | func AllPrompts(t translations.TranslationHelperFunc) []inventory.Server...
FILE: pkg/github/pullrequests.go
function PullRequestRead (line 26) | func PullRequestRead(t translations.TranslationHelperFunc) inventory.Ser...
function GetPullRequest (line 141) | func GetPullRequest(ctx context.Context, client *github.Client, deps Too...
function GetPullRequestDiff (line 198) | func GetPullRequestDiff(ctx context.Context, client *github.Client, owne...
function GetPullRequestStatus (line 228) | func GetPullRequestStatus(ctx context.Context, client *github.Client, ow...
function GetPullRequestCheckRuns (line 274) | func GetPullRequestCheckRuns(ctx context.Context, client *github.Client,...
function GetPullRequestFiles (line 339) | func GetPullRequestFiles(ctx context.Context, client *github.Client, own...
type reviewThreadsQuery (line 368) | type reviewThreadsQuery struct
type reviewThreadNode (line 380) | type reviewThreadNode struct
type reviewCommentNode (line 391) | type reviewCommentNode struct
type pageInfoFragment (line 404) | type pageInfoFragment struct
function GetPullRequestReviewComments (line 411) | func GetPullRequestReviewComments(ctx context.Context, gqlClient *github...
function GetPullRequestReviews (line 481) | func GetPullRequestReviews(ctx context.Context, client *github.Client, d...
constant PullRequestWriteUIResourceURI (line 535) | PullRequestWriteUIResourceURI = "ui://github-mcp-server/pr-write"
function CreatePullRequest (line 538) | func CreatePullRequest(t translations.TranslationHelperFunc) inventory.S...
function UpdatePullRequest (line 702) | func UpdatePullRequest(t translations.TranslationHelperFunc) inventory.S...
function AddReplyToPullRequestComment (line 996) | func AddReplyToPullRequestComment(t translations.TranslationHelperFunc) ...
function ListPullRequests (line 1087) | func ListPullRequests(t translations.TranslationHelperFunc) inventory.Se...
function MergePullRequest (line 1237) | func MergePullRequest(t translations.TranslationHelperFunc) inventory.Se...
function SearchPullRequests (line 1346) | func SearchPullRequests(t translations.TranslationHelperFunc) inventory....
function UpdatePullRequestBranch (line 1408) | func UpdatePullRequestBranch(t translations.TranslationHelperFunc) inven...
type PullRequestReviewWriteParams (line 1502) | type PullRequestReviewWriteParams struct
function PullRequestReviewWrite (line 1513) | func PullRequestReviewWrite(t translations.TranslationHelperFunc) invent...
function CreatePullRequestReview (line 1612) | func CreatePullRequestReview(ctx context.Context, client *githubv4.Clien...
function SubmitPendingPullRequestReview (line 1670) | func SubmitPendingPullRequestReview(ctx context.Context, client *githubv...
function DeletePendingPullRequestReview (line 1755) | func DeletePendingPullRequestReview(ctx context.Context, client *githubv...
function ResolveReviewThread (line 1836) | func ResolveReviewThread(ctx context.Context, client *githubv4.Client, t...
function AddCommentToPendingReview (line 1890) | func AddCommentToPendingReview(t translations.TranslationHelperFunc) inv...
function newGQLStringlike (line 2083) | func newGQLStringlike[T ~string](s string) *T {
function newGQLStringlikePtr (line 2091) | func newGQLStringlikePtr[T ~string](s *string) *T {
function newGQLIntPtr (line 2099) | func newGQLIntPtr(i *int32) *githubv4.Int {
FILE: pkg/github/pullrequests_test.go
function Test_GetPullRequest (line 21) | func Test_GetPullRequest(t *testing.T) {
function Test_UpdatePullRequest (line 142) | func Test_UpdatePullRequest(t *testing.T) {
function Test_UpdatePullRequest_Draft (line 371) | func Test_UpdatePullRequest_Draft(t *testing.T) {
function Test_ListPullRequests (line 555) | func Test_ListPullRequests(t *testing.T) {
function Test_MergePullRequest (line 688) | func Test_MergePullRequest(t *testing.T) {
function Test_SearchPullRequests (line 802) | func Test_SearchPullRequests(t *testing.T) {
function Test_GetPullRequestFiles (line 1089) | func Test_GetPullRequestFiles(t *testing.T) {
function Test_GetPullRequestStatus (line 1246) | func Test_GetPullRequestStatus(t *testing.T) {
function Test_GetPullRequestCheckRuns (line 1407) | func Test_GetPullRequestCheckRuns(t *testing.T) {
function Test_UpdatePullRequestBranch (line 1562) | func Test_UpdatePullRequestBranch(t *testing.T) {
function Test_GetPullRequestComments (line 1678) | func Test_GetPullRequestComments(t *testing.T) {
function Test_GetPullRequestReviews (line 1986) | func Test_GetPullRequestReviews(t *testing.T) {
function Test_CreatePullRequest (line 2165) | func Test_CreatePullRequest(t *testing.T) {
function Test_CreatePullRequest_InsidersMode_UIGate (line 2317) | func Test_CreatePullRequest_InsidersMode_UIGate(t *testing.T) {
function TestCreateAndSubmitPullRequestReview (line 2391) | func TestCreateAndSubmitPullRequestReview(t *testing.T) {
function TestCreatePendingPullRequestReview (line 2650) | func TestCreatePendingPullRequestReview(t *testing.T) {
function TestAddPullRequestReviewCommentToPendingReview (line 2842) | func TestAddPullRequestReviewCommentToPendingReview(t *testing.T) {
function TestSubmitPendingPullRequestReview (line 3084) | func TestSubmitPendingPullRequestReview(t *testing.T) {
function TestDeletePendingPullRequestReview (line 3189) | func TestDeletePendingPullRequestReview(t *testing.T) {
function TestGetPullRequestDiff (line 3288) | func TestGetPullRequestDiff(t *testing.T) {
function viewerQuery (line 3377) | func viewerQuery(login string) githubv4mock.Matcher {
type getLatestPendingReviewQueryReview (line 3393) | type getLatestPendingReviewQueryReview struct
type getLatestPendingReviewQueryParams (line 3399) | type getLatestPendingReviewQueryParams struct
function getLatestPendingReviewQuery (line 3408) | func getLatestPendingReviewQuery(p getLatestPendingReviewQueryParams) gi...
function TestAddReplyToPullRequestComment (line 3449) | func TestAddReplyToPullRequestComment(t *testing.T) {
function TestResolveReviewThread (line 3613) | func TestResolveReviewThread(t *testing.T) {
FILE: pkg/github/repositories.go
function GetCommit (line 23) | func GetCommit(t translations.TranslationHelperFunc) inventory.ServerTool {
function ListCommits (line 121) | func ListCommits(t translations.TranslationHelperFunc) inventory.ServerT...
function ListBranches (line 229) | func ListBranches(t translations.TranslationHelperFunc) inventory.Server...
function CreateOrUpdateFile (line 316) | func CreateOrUpdateFile(t translations.TranslationHelperFunc) inventory....
function CreateRepository (line 512) | func CreateRepository(t translations.TranslationHelperFunc) inventory.Se...
function GetFileContents (line 618) | func GetFileContents(t translations.TranslationHelperFunc) inventory.Ser...
function ForkRepository (line 810) | func ForkRepository(t translations.TranslationHelperFunc) inventory.Serv...
function DeleteFile (line 909) | func DeleteFile(t translations.TranslationHelperFunc) inventory.ServerTo...
function CreateBranch (line 1094) | func CreateBranch(t translations.TranslationHelperFunc) inventory.Server...
function PushFiles (line 1207) | func PushFiles(t translations.TranslationHelperFunc) inventory.ServerTool {
function ListTags (line 1441) | func ListTags(t translations.TranslationHelperFunc) inventory.ServerTool {
function GetTag (line 1527) | func GetTag(t translations.TranslationHelperFunc) inventory.ServerTool {
function ListReleases (line 1625) | func ListReleases(t translations.TranslationHelperFunc) inventory.Server...
function GetLatestRelease (line 1707) | func GetLatestRelease(t translations.TranslationHelperFunc) inventory.Se...
function GetReleaseByTag (line 1772) | func GetReleaseByTag(t translations.TranslationHelperFunc) inventory.Ser...
function ListStarredRepositories (line 1850) | func ListStarredRepositories(t translations.TranslationHelperFunc) inven...
function StarRepository (line 1982) | func StarRepository(t translations.TranslationHelperFunc) inventory.Serv...
function UnstarRepository (line 2048) | func UnstarRepository(t translations.TranslationHelperFunc) inventory.Se...
FILE: pkg/github/repositories_helper.go
function initializeRepository (line 18) | func initializeRepository(ctx context.Context, client *github.Client, ow...
function createReferenceFromDefaultBranch (line 70) | func createReferenceFromDefaultBranch(ctx context.Context, client *githu...
function matchFiles (line 95) | func matchFiles(ctx context.Context, client *github.Client, owner, repo,...
function filterPaths (line 133) | func filterPaths(entries []*github.TreeEntry, path string, maxResults in...
function looksLikeSHA (line 166) | func looksLikeSHA(s string) bool {
function resolveGitReference (line 207) | func resolveGitReference(ctx context.Context, githubClient *github.Clien...
function resolveDefaultBranch (line 305) | func resolveDefaultBranch(ctx context.Context, githubClient *github.Clie...
FILE: pkg/github/repositories_test.go
function Test_GetFileContents (line 24) | func Test_GetFileContents(t *testing.T) {
function Test_ForkRepository (line 480) | func Test_ForkRepository(t *testing.T) {
function Test_CreateBranch (line 582) | func Test_CreateBranch(t *testing.T) {
function Test_GetCommit (line 759) | func Test_GetCommit(t *testing.T) {
function Test_ListCommits (line 888) | func Test_ListCommits(t *testing.T) {
function Test_CreateOrUpdateFile (line 1112) | func Test_CreateOrUpdateFile(t *testing.T) {
function Test_CreateRepository (line 1478) | func Test_CreateRepository(t *testing.T) {
function Test_PushFiles (line 1646) | func Test_PushFiles(t *testing.T) {
function Test_ListBranches (line 2392) | func Test_ListBranches(t *testing.T) {
function Test_DeleteFile (line 2510) | func Test_DeleteFile(t *testing.T) {
function Test_ListTags (line 2694) | func Test_ListTags(t *testing.T) {
function Test_GetTag (line 2824) | func Test_GetTag(t *testing.T) {
function Test_ListReleases (line 2983) | func Test_ListReleases(t *testing.T) {
function Test_GetLatestRelease (line 3081) | func Test_GetLatestRelease(t *testing.T) {
function Test_GetReleaseByTag (line 3170) | func Test_GetReleaseByTag(t *testing.T) {
function Test_looksLikeSHA (line 3341) | func Test_looksLikeSHA(t *testing.T) {
function Test_filterPaths (line 3407) | func Test_filterPaths(t *testing.T) {
function Test_resolveGitReference (line 3502) | func Test_resolveGitReference(t *testing.T) {
function Test_ListStarredRepositories (line 3763) | func Test_ListStarredRepositories(t *testing.T) {
function Test_StarRepository (line 3925) | func Test_StarRepository(t *testing.T) {
function Test_UnstarRepository (line 4016) | func Test_UnstarRepository(t *testing.T) {
FILE: pkg/github/repository_resource.go
function GetRepositoryResourceContent (line 34) | func GetRepositoryResourceContent(t translations.TranslationHelperFunc) ...
function GetRepositoryResourceBranchContent (line 48) | func GetRepositoryResourceBranchContent(t translations.TranslationHelper...
function GetRepositoryResourceCommitContent (line 62) | func GetRepositoryResourceCommitContent(t translations.TranslationHelper...
function GetRepositoryResourceTagContent (line 76) | func GetRepositoryResourceTagContent(t translations.TranslationHelperFun...
function GetRepositoryResourcePrContent (line 90) | func GetRepositoryResourcePrContent(t translations.TranslationHelperFunc...
function repositoryResourceContentsHandlerFunc (line 104) | func repositoryResourceContentsHandlerFunc(resourceURITemplate *uritempl...
function RepositoryResourceContentsHandler (line 112) | func RepositoryResourceContentsHandler(resourceURITemplate *uritemplate....
function expandRepoResourceURI (line 264) | func expandRepoResourceURI(owner, repo, sha, ref string, pathParts []str...
FILE: pkg/github/repository_resource_completions.go
type CompleteHandler (line 14) | type CompleteHandler
function RepositoryResourceCompletionHandler (line 28) | func RepositoryResourceCompletionHandler(getClient GetClientFn) func(ctx...
function completeOwner (line 76) | func completeOwner(ctx context.Context, client *github.Client, _ map[str...
function completeRepo (line 123) | func completeRepo(ctx context.Context, client *github.Client, resolved m...
function completeBranch (line 150) | func completeBranch(ctx context.Context, client *github.Client, resolved...
function completeSHA (line 170) | func completeSHA(ctx context.Context, client *github.Client, resolved ma...
function completeTag (line 191) | func completeTag(ctx context.Context, client *github.Client, resolved ma...
function completePRNumber (line 210) | func completePRNumber(ctx context.Context, client *github.Client, resolv...
function completePath (line 234) | func completePath(ctx context.Context, client *github.Client, resolved m...
FILE: pkg/github/repository_resource_completions_test.go
function TestRepositoryResourceCompletionHandler (line 15) | func TestRepositoryResourceCompletionHandler(t *testing.T) {
function TestRepositoryResourceCompletionHandler_GetClientError (line 84) | func TestRepositoryResourceCompletionHandler_GetClientError(t *testing.T) {
function TestCompleteRepo_MissingOwner (line 114) | func TestCompleteRepo_MissingOwner(t *testing.T) {
function TestCompleteBranch_MissingDependencies (line 124) | func TestCompleteBranch_MissingDependencies(t *testing.T) {
function TestCompleteSHA_MissingDependencies (line 140) | func TestCompleteSHA_MissingDependencies(t *testing.T) {
function TestCompleteTag_MissingDependencies (line 156) | func TestCompleteTag_MissingDependencies(t *testing.T) {
function TestCompletePRNumber_MissingDependencies (line 172) | func TestCompletePRNumber_MissingDependencies(t *testing.T) {
function TestCompletePath_MissingDependencies (line 188) | func TestCompletePath_MissingDependencies(t *testing.T) {
function TestCompletePath_RefSelection (line 204) | func TestCompletePath_RefSelection(t *testing.T) {
function TestRepositoryResourceArgumentResolvers_Existence (line 230) | func TestRepositoryResourceArgumentResolvers_Existence(t *testing.T) {
function TestRepositoryResourceCompletionHandler_MaxResults (line 247) | func TestRepositoryResourceCompletionHandler_MaxResults(t *testing.T) {
function TestRepositoryResourceCompletionHandler_WithContext (line 292) | func TestRepositoryResourceCompletionHandler_WithContext(t *testing.T) {
function TestRepositoryResourceCompletionHandler_NilContext (line 335) | func TestRepositoryResourceCompletionHandler_NilContext(t *testing.T) {
FILE: pkg/github/repository_resource_test.go
type errorTransport (line 17) | type errorTransport struct
method RoundTrip (line 21) | func (t *errorTransport) RoundTrip(*http.Request) (*http.Response, err...
type resourceResponseType (line 25) | type resourceResponseType
constant resourceResponseTypeUnknown (line 28) | resourceResponseTypeUnknown resourceResponseType = iota
constant resourceResponseTypeBlob (line 29) | resourceResponseTypeBlob
constant resourceResponseTypeText (line 30) | resourceResponseTypeText
function Test_repositoryResourceContents (line 33) | func Test_repositoryResourceContents(t *testing.T) {
function Test_repositoryResourceContentsHandler_NetworkError (line 288) | func Test_repositoryResourceContentsHandler_NetworkError(t *testing.T) {
FILE: pkg/github/resources.go
function AllResources (line 10) | func AllResources(t translations.TranslationHelperFunc) []inventory.Serv...
FILE: pkg/github/scope_filter.go
function onlyRequiresRepoScopes (line 21) | func onlyRequiresRepoScopes(acceptedScopes []string) bool {
function CreateToolScopeFilter (line 56) | func CreateToolScopeFilter(tokenScopes []string) inventory.ToolFilter {
FILE: pkg/github/scope_filter_test.go
function TestCreateToolScopeFilter (line 13) | func TestCreateToolScopeFilter(t *testing.T) {
function TestCreateToolScopeFilter_Integration (line 146) | func TestCreateToolScopeFilter_Integration(t *testing.T) {
FILE: pkg/github/search.go
function SearchRepositories (line 21) | func SearchRepositories(t translations.TranslationHelperFunc) inventory....
function SearchCode (line 170) | func SearchCode(t translations.TranslationHelperFunc) inventory.ServerTo...
function userOrOrgHandler (line 264) | func userOrOrgHandler(ctx context.Context, accountType string, deps Tool...
function SearchUsers (line 351) | func SearchUsers(t translations.TranslationHelperFunc) inventory.ServerT...
function SearchOrgs (line 393) | func SearchOrgs(t translations.TranslationHelperFunc) inventory.ServerTo...
FILE: pkg/github/search_test.go
function Test_SearchRepositories (line 17) | func Test_SearchRepositories(t *testing.T) {
function Test_SearchRepositories_FullOutput (line 171) | func Test_SearchRepositories_FullOutput(t *testing.T) {
function Test_SearchCode (line 231) | func Test_SearchCode(t *testing.T) {
function Test_SearchUsers (line 383) | func Test_SearchUsers(t *testing.T) {
function Test_SearchOrgs (line 569) | func Test_SearchOrgs(t *testing.T) {
FILE: pkg/github/search_utils.go
function hasFilter (line 17) | func hasFilter(query, filterType string) bool {
function hasSpecificFilter (line 24) | func hasSpecificFilter(query, filterType, filterValue string) bool {
function hasRepoFilter (line 32) | func hasRepoFilter(query string) bool {
function hasTypeFilter (line 36) | func hasTypeFilter(query string) bool {
function searchHandler (line 40) | func searchHandler(
FILE: pkg/github/search_utils_test.go
function Test_hasFilter (line 9) | func Test_hasFilter(t *testing.T) {
function Test_hasRepoFilter (line 116) | func Test_hasRepoFilter(t *testing.T) {
function Test_hasSpecificFilter (line 182) | func Test_hasSpecificFilter(t *testing.T) {
function Test_hasTypeFilter (line 298) | func Test_hasTypeFilter(t *testing.T) {
FILE: pkg/github/secret_scanning.go
function GetSecretScanningAlert (line 20) | func GetSecretScanningAlert(t translations.TranslationHelperFunc) invent...
function ListSecretScanningAlerts (line 97) | func ListSecretScanningAlerts(t translations.TranslationHelperFunc) inve...
FILE: pkg/github/secret_scanning_test.go
function Test_GetSecretScanningAlert (line 17) | func Test_GetSecretScanningAlert(t *testing.T) {
function Test_ListSecretScanningAlerts (line 121) | func Test_ListSecretScanningAlerts(t *testing.T) {
FILE: pkg/github/security_advisories.go
function ListGlobalSecurityAdvisories (line 20) | func ListGlobalSecurityAdvisories(t translations.TranslationHelperFunc) ...
function ListRepositorySecurityAdvisories (line 211) | func ListRepositorySecurityAdvisories(t translations.TranslationHelperFu...
function GetGlobalSecurityAdvisory (line 315) | func GetGlobalSecurityAdvisory(t translations.TranslationHelperFunc) inv...
function ListOrgRepositorySecurityAdvisories (line 372) | func ListOrgRepositorySecurityAdvisories(t translations.TranslationHelpe...
FILE: pkg/github/security_advisories_test.go
function Test_ListGlobalSecurityAdvisories (line 17) | func Test_ListGlobalSecurityAdvisories(t *testing.T) {
function Test_GetGlobalSecurityAdvisory (line 132) | func Test_GetGlobalSecurityAdvisory(t *testing.T) {
function Test_ListRepositorySecurityAdvisories (line 238) | func Test_ListRepositorySecurityAdvisories(t *testing.T) {
function Test_ListOrgRepositorySecurityAdvisories (line 373) | func Test_ListOrgRepositorySecurityAdvisories(t *testing.T) {
FILE: pkg/github/server.go
type MCPServerConfig (line 19) | type MCPServerConfig struct
type MCPServerOption (line 79) | type MCPServerOption
function NewMCPServer (line 81) | func NewMCPServer(ctx context.Context, cfg *MCPServerConfig, deps ToolDe...
function registerDynamicTools (line 132) | func registerDynamicTools(server *mcp.Server, inventory *inventory.Inven...
function ResolvedEnabledToolsets (line 146) | func ResolvedEnabledToolsets(dynamicToolsets bool, enabledToolsets []str...
function addGitHubAPIErrorToContext (line 170) | func addGitHubAPIErrorToContext(next mcp.MethodHandler) mcp.MethodHandler {
function NewServer (line 182) | func NewServer(version, name, title string, opts *mcp.ServerOptions) *mc...
function CompletionsHandler (line 205) | func CompletionsHandler(getClient GetClientFn) func(ctx context.Context,...
function MarshalledTextResult (line 221) | func MarshalledTextResult(v any) *mcp.CallToolResult {
FILE: pkg/github/server_test.go
type stubDeps (line 24) | type stubDeps struct
method GetClient (line 35) | func (s stubDeps) GetClient(ctx context.Context) (*gogithub.Client, er...
method GetGQLClient (line 42) | func (s stubDeps) GetGQLClient(ctx context.Context) (*githubv4.Client,...
method GetRawClient (line 49) | func (s stubDeps) GetRawClient(ctx context.Context) (*raw.Client, erro...
method GetRepoAccessCache (line 56) | func (s stubDeps) GetRepoAccessCache(_ context.Context) (*lockdown.Rep...
method GetT (line 59) | func (s stubDeps) GetT() translations.TranslationHelperFunc {...
method GetFlags (line 60) | func (s stubDeps) GetFlags(_ context.Context) FeatureFlags {...
method GetContentWindowSize (line 61) | func (s stubDeps) GetContentWindowSize() int {...
method IsFeatureEnabled (line 62) | func (s stubDeps) IsFeatureEnabled(_ context.Context, _ string) bool {...
function stubClientFnFromHTTP (line 65) | func stubClientFnFromHTTP(httpClient *http.Client) func(context.Context)...
function stubClientFnErr (line 71) | func stubClientFnErr(errMsg string) func(context.Context) (*gogithub.Cli...
function stubGQLClientFnErr (line 77) | func stubGQLClientFnErr(errMsg string) func(context.Context) (*githubv4....
function stubRepoAccessCache (line 83) | func stubRepoAccessCache(client *githubv4.Client, ttl time.Duration) *lo...
function stubFeatureFlags (line 88) | func stubFeatureFlags(enabledFlags map[string]bool) FeatureFlags {
function badRequestHandler (line 95) | func badRequestHandler(msg string) http.HandlerFunc {
function TestNewMCPServer_CreatesSuccessfully (line 112) | func TestNewMCPServer_CreatesSuccessfully(t *testing.T) {
function TestNewServer_NameAndTitleViaTranslation (line 158) | func TestNewServer_NameAndTitleViaTranslation(t *testing.T) {
function TestResolveEnabledToolsets (line 242) | func TestResolveEnabledToolsets(t *testing.T) {
FILE: pkg/github/tools.go
type GetClientFn (line 14) | type GetClientFn
type GetGQLClientFn (line 15) | type GetGQLClientFn
function AllTools (line 160) | func AllTools(t translations.TranslationHelperFunc) []inventory.ServerTo...
function ToBoolPtr (line 281) | func ToBoolPtr(b bool) *bool {
function ToStringPtr (line 287) | func ToStringPtr(s string) *string {
function GenerateToolsetsHelp (line 295) | func GenerateToolsetsHelp() string {
function stubTranslator (line 359) | func stubTranslator(_, fallback string) string { return fallback }
function AddDefaultToolset (line 362) | func AddDefaultToolset(result []string) []string {
function RemoveToolset (line 390) | func RemoveToolset(tools []string, toRemove string) []string {
function ContainsToolset (line 400) | func ContainsToolset(tools []string, toCheck string) bool {
function CleanTools (line 406) | func CleanTools(toolNames []string) []string {
function GetDefaultToolsetIDs (line 427) | func GetDefaultToolsetIDs() []string {
function RemoteOnlyToolsets (line 441) | func RemoteOnlyToolsets() []inventory.ToolsetMetadata {
FILE: pkg/github/tools_test.go
function TestAddDefaultToolset (line 10) | func TestAddDefaultToolset(t *testing.T) {
function TestRemoveToolset (line 88) | func TestRemoveToolset(t *testing.T) {
function TestContainsToolset (line 123) | func TestContainsToolset(t *testing.T) {
function TestGenerateToolsetsHelp (line 158) | func TestGenerateToolsetsHelp(t *testing.T) {
FILE: pkg/github/tools_validation_test.go
function stubTranslation (line 12) | func stubTranslation(_, fallback string) string {
function TestAllToolsHaveRequiredMetadata (line 19) | func TestAllToolsHaveRequiredMetadata(t *testing.T) {
function TestAllResourcesHaveRequiredMetadata (line 46) | func TestAllResourcesHaveRequiredMetadata(t *testing.T) {
function TestAllPromptsHaveRequiredMetadata (line 66) | func TestAllPromptsHaveRequiredMetadata(t *testing.T) {
function TestToolReadOnlyHintConsistency (line 85) | func TestToolReadOnlyHintConsistency(t *testing.T) {
function TestNoDuplicateToolNames (line 101) | func TestNoDuplicateToolNames(t *testing.T) {
function TestNoDuplicateResourceNames (line 131) | func TestNoDuplicateResourceNames(t *testing.T) {
function TestNoDuplicatePromptNames (line 144) | func TestNoDuplicatePromptNames(t *testing.T) {
function TestAllToolsHaveHandlerFunc (line 157) | func TestAllToolsHaveHandlerFunc(t *testing.T) {
function TestToolsetMetadataConsistency (line 171) | func TestToolsetMetadataConsistency(t *testing.T) {
FILE: pkg/github/toolset_icons_test.go
function TestAllToolsetIconsExist (line 14) | func TestAllToolsetIconsExist(t *testing.T) {
function TestToolsetMetadataHasIcons (line 69) | func TestToolsetMetadataHasIcons(t *testing.T) {
FILE: pkg/github/toolset_instructions.go
function generateContextToolsetInstructions (line 8) | func generateContextToolsetInstructions(_ *inventory.Inventory) string {
function generateIssuesToolsetInstructions (line 12) | func generateIssuesToolsetInstructions(_ *inventory.Inventory) string {
function generatePullRequestsToolsetInstructions (line 18) | func generatePullRequestsToolsetInstructions(inv *inventory.Inventory) s...
function generateDiscussionsToolsetInstructions (line 31) | func generateDiscussionsToolsetInstructions(_ *inventory.Inventory) stri...
function generateProjectsToolsetInstructions (line 37) | func generateProjectsToolsetInstructions(_ *inventory.Inventory) string {
FILE: pkg/github/ui_capability.go
constant mcpAppsExtensionKey (line 12) | mcpAppsExtensionKey = "io.modelcontextprotocol/ui"
constant MCPAppMIMEType (line 15) | MCPAppMIMEType = "text/html;profile=mcp-app"
function clientSupportsUI (line 21) | func clientSupportsUI(ctx context.Context, req *mcp.CallToolRequest) bool {
FILE: pkg/github/ui_capability_test.go
function createMCPRequestWithCapabilities (line 13) | func createMCPRequestWithCapabilities(t *testing.T, caps *mcp.ClientCapa...
function Test_clientSupportsUI (line 30) | func Test_clientSupportsUI(t *testing.T) {
function Test_clientSupportsUI_fromContext (line 63) | func Test_clientSupportsUI_fromContext(t *testing.T) {
FILE: pkg/github/ui_embed.go
function GetUIAsset (line 16) | func GetUIAsset(name string) (string, error) {
function MustGetUIAsset (line 26) | func MustGetUIAsset(name string) string {
function UIAssetsAvailable (line 38) | func UIAssetsAvailable() bool {
FILE: pkg/github/ui_resources.go
function RegisterUIResources (line 13) | func RegisterUIResources(s *mcp.Server) {
FILE: pkg/github/workflow_prompts.go
function IssueToFixWorkflowPrompt (line 13) | func IssueToFixWorkflowPrompt(t translations.TranslationHelperFunc) inve...
FILE: pkg/http/handler.go
type InventoryFactoryFunc (line 21) | type InventoryFactoryFunc
type GitHubMCPServerFactoryFunc (line 25) | type GitHubMCPServerFactoryFunc
type Handler (line 27) | type Handler struct
method RegisterMiddleware (line 128) | func (h *Handler) RegisterMiddleware(r chi.Router) {
method RegisterRoutes (line 143) | func (h *Handler) RegisterRoutes(r chi.Router) {
method ServeHTTP (line 182) | func (h *Handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
type HandlerOptions (line 41) | type HandlerOptions struct
type HandlerOption (line 49) | type HandlerOption
function WithScopeFetcher (line 51) | func WithScopeFetcher(f scopes.FetcherInterface) HandlerOption {
function WithGitHubMCPServerFactory (line 57) | func WithGitHubMCPServerFactory(f GitHubMCPServerFactoryFunc) HandlerOpt...
function WithInventoryFactory (line 63) | func WithInventoryFactory(f InventoryFactoryFunc) HandlerOption {
function WithOAuthConfig (line 69) | func WithOAuthConfig(cfg *oauth.Config) HandlerOption {
function WithFeatureChecker (line 75) | func WithFeatureChecker(checker inventory.FeatureFlagChecker) HandlerOpt...
function NewHTTPMcpHandler (line 81) | func NewHTTPMcpHandler(
function withReadonly (line 158) | func withReadonly(next http.Handler) http.Handler {
function withToolset (line 166) | func withToolset(next http.Handler) http.Handler {
function withInsiders (line 175) | func withInsiders(next http.Handler) http.Handler {
function DefaultGitHubMCPServerFactory (line 235) | func DefaultGitHubMCPServerFactory(r *http.Request, deps github.ToolDepe...
function DefaultInventoryFactory (line 240) | func DefaultInventoryFactory(_ *ServerConfig, t translations.Translation...
function InventoryFiltersForRequest (line 257) | func InventoryFiltersForRequest(r *http.Request, builder *inventory.Buil...
function PATScopeFilter (line 285) | func PATScopeFilter(b *inventory.Builder, r *http.Request, fetcher scope...
FILE: pkg/http/handler_test.go
function mockTool (line 25) | func mockTool(name, toolsetID string, readOnly bool) inventory.ServerTool {
type allScopesFetcher (line 38) | type allScopesFetcher struct
method FetchTokenScopes (line 40) | func (f allScopesFetcher) FetchTokenScopes(_ context.Context, _ string...
function mockToolWithFeatureFlag (line 52) | func mockToolWithFeatureFlag(name, toolsetID string, readOnly bool, enab...
function TestInventoryFiltersForRequest (line 59) | func TestInventoryFiltersForRequest(t *testing.T) {
function testTools (line 159) | func testTools() []inventory.ServerTool {
function extractToolNames (line 174) | func extractToolNames(ctx context.Context, inv *inventory.Inventory) []s...
function TestHTTPHandlerRoutes (line 184) | func TestHTTPHandlerRoutes(t *testing.T) {
FILE: pkg/http/headers/headers.go
constant AuthorizationHeader (line 5) | AuthorizationHeader = "Authorization"
constant ContentTypeHeader (line 7) | ContentTypeHeader = "Content-Type"
constant AcceptHeader (line 9) | AcceptHeader = "Accept"
constant UserAgentHeader (line 11) | UserAgentHeader = "User-Agent"
constant ContentTypeJSON (line 14) | ContentTypeJSON = "application/json"
constant ContentTypeEventStream (line 16) | ContentTypeEventStream = "text/event-stream"
constant ForwardedForHeader (line 19) | ForwardedForHeader = "X-Forwarded-For"
constant RealIPHeader (line 22) | RealIPHeader = "X-Real-IP"
constant ForwardedHostHeader (line 25) | ForwardedHostHeader = "X-Forwarded-Host"
constant ForwardedProtoHeader (line 27) | ForwardedProtoHeader = "X-Forwarded-Proto"
constant RequestHmacHeader (line 30) | RequestHmacHeader = "Request-Hmac"
constant MCPReadOnlyHeader (line 35) | MCPReadOnlyHeader = "X-MCP-Readonly"
constant MCPToolsetsHeader (line 37) | MCPToolsetsHeader = "X-MCP-Toolsets"
constant MCPToolsHeader (line 39) | MCPToolsHeader = "X-MCP-Tools"
constant MCPLockdownHeader (line 41) | MCPLockdownHeader = "X-MCP-Lockdown"
constant MCPInsidersHeader (line 43) | MCPInsidersHeader = "X-MCP-Insiders"
constant MCPExcludeToolsHeader (line 46) | MCPExcludeToolsHeader = "X-MCP-Exclude-Tools"
constant MCPFeaturesHeader (line 48) | MCPFeaturesHeader = "X-MCP-Features"
constant GraphQLFeaturesHeader (line 53) | GraphQLFeaturesHeader = "GraphQL-Features"
constant GitHubAPIVersionHeader (line 55) | GitHubAPIVersionHeader = "X-GitHub-Api-Version"
FILE: pkg/http/headers/parse.go
function ParseCommaSeparated (line 7) | func ParseCommaSeparated(value string) []string {
FILE: pkg/http/headers/parse_test.go
function TestParseCommaSeparated (line 9) | func TestParseCommaSeparated(t *testing.T) {
FILE: pkg/http/mark/mark.go
function With (line 35) | func With(err, markErr error) error {
type marked (line 42) | type marked struct
method Is (line 47) | func (f marked) Is(target error) bool {
method As (line 53) | func (f marked) As(target any) bool {
method Unwrap (line 59) | func (f marked) Unwrap() error {
method Error (line 63) | func (f marked) Error() string {
FILE: pkg/http/middleware/mcp_parse.go
type mcpJSONRPCRequest (line 14) | type mcpJSONRPCRequest struct
function WithMCPParse (line 37) | func WithMCPParse() func(http.Handler) http.Handler {
FILE: pkg/http/middleware/mcp_parse_test.go
function TestWithMCPParse (line 15) | func TestWithMCPParse(t *testing.T) {
function TestWithMCPParse_BodyRestoration (line 171) | func TestWithMCPParse_BodyRestoration(t *testing.T) {
FILE: pkg/http/middleware/pat_scope.go
function WithPATScopes (line 13) | func WithPATScopes(logger *slog.Logger, scopeFetcher scopes.FetcherInter...
FILE: pkg/http/middleware/pat_scope_test.go
type mockScopeFetcher (line 18) | type mockScopeFetcher struct
method FetchTokenScopes (line 23) | func (m *mockScopeFetcher) FetchTokenScopes(_ context.Context, _ strin...
function TestWithPATScopes (line 27) | func TestWithPATScopes(t *testing.T) {
function TestWithPATScopes_PreservesExistingTokenInfo (line 153) | func TestWithPATScopes_PreservesExistingTokenInfo(t *testing.T) {
FILE: pkg/http/middleware/request_config.go
function WithRequestConfig (line 14) | func WithRequestConfig(next http.Handler) http.Handler {
function relaxedParseBool (line 60) | func relaxedParseBool(s string) bool {
FILE: pkg/http/middleware/scope_challenge.go
function WithScopeChallenge (line 19) | func WithScopeChallenge(oauthCfg *oauth.Config, scopeFetcher scopes.Fetc...
FILE: pkg/http/middleware/token.go
function ExtractUserToken (line 13) | func ExtractUserToken(oauthCfg *oauth.Config) func(next http.Handler) ht...
function sendAuthChallenge (line 51) | func sendAuthChallenge(w http.ResponseWriter, r *http.Request, oauthCfg ...
FILE: pkg/http/middleware/token_test.go
function TestExtractUserToken (line 16) | func TestExtractUserToken(t *testing.T) {
function TestExtractUserToken_NilOAuthConfig (line 211) | func TestExtractUserToken_NilOAuthConfig(t *testing.T) {
function TestExtractUserToken_MissingAuthHeader_WWWAuthenticateFormat (line 235) | func TestExtractUserToken_MissingAuthHeader_WWWAuthenticateFormat(t *tes...
function TestSendAuthChallenge (line 263) | func TestSendAuthChallenge(t *testing.T) {
FILE: pkg/http/oauth/oauth.go
constant OAuthProtectedResourcePrefix (line 19) | OAuthProtectedResourcePrefix = "/.well-known/oauth-protected-resource"
type Config (line 39) | type Config struct
type AuthHandler (line 55) | type AuthHandler struct
method RegisterRoutes (line 90) | func (h *AuthHandler) RegisterRoutes(r chi.Router) {
method metadataHandler (line 99) | func (h *AuthHandler) metadataHandler() http.Handler {
method routesForPattern (line 136) | func (h *AuthHandler) routesForPattern(pattern string) []string {
method buildResourceURL (line 183) | func (h *AuthHandler) buildResourceURL(r *http.Request, resourcePath s...
function NewAuthHandler (line 61) | func NewAuthHandler(cfg *Config, apiHost utils.APIHostResolver) (*AuthHa...
function resolveResourcePath (line 155) | func resolveResourcePath(path, basePath string) string {
function ResolveResourcePath (line 174) | func ResolveResourcePath(r *http.Request, cfg *Config) string {
function GetEffectiveHostAndScheme (line 199) | func GetEffectiveHostAndScheme(r *http.Request, cfg *Config) (host, sche...
function BuildResourceMetadataURL (line 221) | func BuildResourceMetadataURL(r *http.Request, cfg *Config, resourcePath...
function normalizeBasePath (line 237) | func normalizeBasePath(path string) string {
function joinRoute (line 248) | func joinRoute(basePath, pattern string) string {
FILE: pkg/http/oauth/oauth_test.go
function TestNewAuthHandler (line 21) | func TestNewAuthHandler(t *testing.T) {
function TestGetEffectiveHostAndScheme (line 66) | func TestGetEffectiveHostAndScheme(t *testing.T) {
function TestResolveResourcePath (line 176) | func TestResolveResourcePath(t *testing.T) {
function TestBuildResourceMetadataURL (line 247) | func TestBuildResourceMetadataURL(t *testing.T) {
function TestHandleProtectedResource (line 341) | func TestHandleProtectedResource(t *testing.T) {
function TestRegisterRoutes (line 493) | func TestRegisterRoutes(t *testing.T) {
function TestSupportedScopes (line 540) | func TestSupportedScopes(t *testing.T) {
function TestProtectedResourceResponseFormat (line 562) | func TestProtectedResourceResponseFormat(t *testing.T) {
function TestOAuthProtectedResourcePrefix (line 610) | func TestOAuthProtectedResourcePrefix(t *testing.T) {
function TestDefaultAuthorizationServer (line 617) | func TestDefaultAuthorizationServer(t *testing.T) {
function TestAPIHostResolver_AuthorizationServerURL (line 623) | func TestAPIHostResolver_AuthorizationServerURL(t *testing.T) {
FILE: pkg/http/server.go
type ServerConfig (line 30) | type ServerConfig struct
function RunHTTPServer (line 72) | func RunHTTPServer(cfg ServerConfig) error {
function initGlobalToolScopeMap (line 190) | func initGlobalToolScopeMap(t translations.TranslationHelperFunc) error {
function createHTTPFeatureChecker (line 208) | func createHTTPFeatureChecker() inventory.FeatureFlagChecker {
FILE: pkg/http/transport/bearer.go
type BearerAuthTransport (line 11) | type BearerAuthTransport struct
method RoundTrip (line 16) | func (t *BearerAuthTransport) RoundTrip(req *http.Request) (*http.Resp...
FILE: pkg/http/transport/graphql_features.go
type GraphQLFeaturesTransport (line 31) | type GraphQLFeaturesTransport struct
method RoundTrip (line 37) | func (t *GraphQLFeaturesTransport) RoundTrip(req *http.Request) (*http...
FILE: pkg/http/transport/graphql_features_test.go
function TestGraphQLFeaturesTransport (line 16) | func TestGraphQLFeaturesTransport(t *testing.T) {
function TestGraphQLFeaturesTransport_NilTransport (line 94) | func TestGraphQLFeaturesTransport_NilTransport(t *testing.T) {
function TestGraphQLFeaturesTransport_DoesNotMutateOriginalRequest (line 125) | func TestGraphQLFeaturesTransport_DoesNotMutateOriginalRequest(t *testin...
FILE: pkg/http/transport/user_agent.go
type UserAgentTransport (line 9) | type UserAgentTransport struct
method RoundTrip (line 14) | func (t *UserAgentTransport) RoundTrip(req *http.Request) (*http.Respo...
FILE: pkg/inventory/builder.go
type ToolFilter (line 19) | type ToolFilter
type Builder (line 37) | type Builder struct
method SetTools (line 63) | func (b *Builder) SetTools(tools []ServerTool) *Builder {
method SetResources (line 69) | func (b *Builder) SetResources(resources []ServerResourceTemplate) *Bu...
method SetPrompts (line 75) | func (b *Builder) SetPrompts(prompts []ServerPrompt) *Builder {
method WithDeprecatedAliases (line 82) | func (b *Builder) WithDeprecatedAliases(aliases map[string]string) *Bu...
method WithReadOnly (line 89) | func (b *Builder) WithReadOnly(readOnly bool) *Builder {
method WithServerInstructions (line 94) | func (b *Builder) WithServerInstructions() *Builder {
method WithToolsets (line 108) | func (b *Builder) WithToolsets(toolsetIDs []string) *Builder {
method WithTools (line 120) | func (b *Builder) WithTools(toolNames []string) *Builder {
method WithFeatureChecker (line 130) | func (b *Builder) WithFeatureChecker(checker FeatureFlagChecker) *Buil...
method WithFilter (line 139) | func (b *Builder) WithFilter(filter ToolFilter) *Builder {
method WithExcludeTools (line 149) | func (b *Builder) WithExcludeTools(toolNames []string) *Builder {
method WithInsidersMode (line 161) | func (b *Builder) WithInsidersMode(enabled bool) *Builder {
method Build (line 206) | func (b *Builder) Build() (*Inventory, error) {
method processToolsets (line 273) | func (b *Builder) processToolsets() (map[ToolsetID]bool, []string, []T...
function NewBuilder (line 55) | func NewBuilder() *Builder {
function CreateExcludeToolsFilter (line 169) | func CreateExcludeToolsFilter(excluded []string) ToolFilter {
function cleanTools (line 182) | func cleanTools(tools []string) []string {
function stripInsidersFeatures (line 388) | func stripInsidersFeatures(tools []ServerTool) []ServerTool {
function stripInsidersMetaFromTool (line 406) | func stripInsidersMetaFromTool(tool ServerTool) *ServerTool {
FILE: pkg/inventory/errors.go
type ToolsetDoesNotExistError (line 6) | type ToolsetDoesNotExistError struct
method Error (line 10) | func (e *ToolsetDoesNotExistError) Error() string {
method Is (line 14) | func (e *ToolsetDoesNotExistError) Is(target error) bool {
function NewToolsetDoesNotExistError (line 25) | func NewToolsetDoesNotExistError(name string) *ToolsetDoesNotExistError {
type ToolDoesNotExistError (line 30) | type ToolDoesNotExistError struct
method Error (line 34) | func (e *ToolDoesNotExistError) Error() string {
function NewToolDoesNotExistError (line 39) | func NewToolDoesNotExistError(name string) *ToolDoesNotExistError {
FILE: pkg/inventory/filters.go
type FeatureFlagChecker (line 14) | type FeatureFlagChecker
method isToolsetEnabled (line 17) | func (r *Inventory) isToolsetEnabled(toolsetID ToolsetID) bool {
method checkFeatureFlag (line 27) | func (r *Inventory) checkFeatureFlag(ctx context.Context, flagName strin...
method isFeatureFlagAllowed (line 42) | func (r *Inventory) isFeatureFlagAllowed(ctx context.Context, enableFlag...
method isToolEnabled (line 61) | func (r *Inventory) isToolEnabled(ctx context.Context, tool *ServerTool)...
method AvailableTools (line 106) | func (r *Inventory) AvailableTools(ctx context.Context) []ServerTool {
method AvailableResourceTemplates (line 129) | func (r *Inventory) AvailableResourceTemplates(ctx context.Context) []Se...
method AvailablePrompts (line 156) | func (r *Inventory) AvailablePrompts(ctx context.Context) []ServerPrompt {
method filterToolsByName (line 185) | func (r *Inventory) filterToolsByName(name string) []ServerTool {
method filterPromptsByName (line 209) | func (r *Inventory) filterPromptsByName(name string) []ServerPrompt {
method ToolsForToolset (line 221) | func (r *Inventory) ToolsForToolset(toolsetID ToolsetID) []ServerTool {
method IsToolsetEnabled (line 243) | func (r *Inventory) IsToolsetEnabled(toolsetID ToolsetID) bool {
method EnableToolset (line 249) | func (r *Inventory) EnableToolset(toolsetID ToolsetID) {
method EnabledToolsetIDs (line 259) | func (r *Inventory) EnabledToolsetIDs() []ToolsetID {
method FilteredTools (line 284) | func (r *Inventory) FilteredTools(ctx context.Context) ([]ServerTool, er...
FILE: pkg/inventory/instructions.go
function generateInstructions (line 9) | func generateInstructions(inv *Inventory) string {
FILE: pkg/inventory/instructions_test.go
function createTestInventory (line 11) | func createTestInventory(toolsets []ToolsetMetadata) *Inventory {
function TestGenerateInstructions (line 28) | func TestGenerateInstructions(t *testing.T) {
function TestGenerateInstructionsWithDisableFlag (line 82) | func TestGenerateInstructionsWithDisableFlag(t *testing.T) {
function TestToolsetInstructionsFunc (line 142) | func TestToolsetInstructionsFunc(t *testing.T) {
function TestGenerateInstructionsOnlyEnabledToolsets (line 212) | func TestGenerateInstructionsOnlyEnabledToolsets(t *testing.T) {
FILE: pkg/inventory/prompts.go
type ServerPrompt (line 6) | type ServerPrompt struct
function NewServerPrompt (line 20) | func NewServerPrompt(toolset ToolsetMetadata, prompt mcp.Prompt, handler...
FILE: pkg/inventory/registry.go
type Inventory (line 27) | type Inventory struct
method UnrecognizedToolsets (line 67) | func (r *Inventory) UnrecognizedToolsets() []string {
method ForMCPRequest (line 102) | func (r *Inventory) ForMCPRequest(method string, itemName string) *Inv...
method ToolsetIDs (line 156) | func (r *Inventory) ToolsetIDs() []ToolsetID {
method DefaultToolsetIDs (line 162) | func (r *Inventory) DefaultToolsetIDs() []ToolsetID {
method ToolsetDescriptions (line 167) | func (r *Inventory) ToolsetDescriptions() map[ToolsetID]string {
method RegisterTools (line 173) | func (r *Inventory) RegisterTools(ctx context.Context, s *mcp.Server, ...
method RegisterResourceTemplates (line 182) | func (r *Inventory) RegisterResourceTemplates(ctx context.Context, s *...
method RegisterPrompts (line 197) | func (r *Inventory) RegisterPrompts(ctx context.Context, s *mcp.Server) {
method RegisterAll (line 211) | func (r *Inventory) RegisterAll(ctx context.Context, s *mcp.Server, de...
method ResolveToolAliases (line 222) | func (r *Inventory) ResolveToolAliases(toolNames []string) (resolved [...
method FindToolByName (line 240) | func (r *Inventory) FindToolByName(toolName string) (*ServerTool, Tool...
method HasToolset (line 250) | func (r *Inventory) HasToolset(toolsetID ToolsetID) bool {
method AllTools (line 255) | func (r *Inventory) AllTools() []ServerTool {
method AvailableToolsets (line 273) | func (r *Inventory) AvailableToolsets(exclude ...ToolsetID) []ToolsetM...
method EnabledToolsets (line 301) | func (r *Inventory) EnabledToolsets() []ToolsetMetadata {
method Instructions (line 320) | func (r *Inventory) Instructions() string {
constant MCPMethodInitialize (line 73) | MCPMethodInitialize = "initialize"
constant MCPMethodToolsList (line 74) | MCPMethodToolsList = "tools/list"
constant MCPMethodToolsCall (line 75) | MCPMethodToolsCall = "tools/call"
constant MCPMethodResourcesList (line 76) | MCPMethodResourcesList = "resources/list"
constant MCPMethodResourcesRead (line 77) | MCPMethodResourcesRead = "resources/read"
constant MCPMethodResourcesTemplatesList (line 78) | MCPMethodResourcesTemplatesList = "resources/templates/list"
constant MCPMethodPromptsList (line 79) | MCPMethodPromptsList = "prompts/list"
constant MCPMethodPromptsGet (line 80) | MCPMethodPromptsGet = "prompts/get"
FILE: pkg/inventory/registry_test.go
function mustBuild (line 15) | func mustBuild(t *testing.T, b *Builder) *Inventory {
function testToolsetMetadata (line 23) | func testToolsetMetadata(id string) ToolsetMetadata {
function testToolsetMetadataWithDefault (line 31) | func testToolsetMetadataWithDefault(id string, isDefault bool) ToolsetMe...
function mockToolWithDefault (line 40) | func mockToolWithDefault(name string, toolsetID string, readOnly bool, i...
function mockTool (line 59) | func mockTool(name string, toolsetID string, readOnly bool) ServerTool {
function TestNewRegistryEmpty (line 77) | func TestNewRegistryEmpty(t *testing.T) {
function TestNewRegistryWithTools (line 90) | func TestNewRegistryWithTools(t *testing.T) {
function TestAvailableTools_NoFilters (line 104) | func TestAvailableTools_NoFilters(t *testing.T) {
function TestWithReadOnly (line 127) | func TestWithReadOnly(t *testing.T) {
function TestWithToolsets (line 151) | func TestWithToolsets(t *testing.T) {
function TestWithToolsetsTrimsWhitespace (line 183) | func TestWithToolsetsTrimsWhitespace(t *testing.T) {
function TestWithToolsetsDeduplicates (line 198) | func TestWithToolsetsDeduplicates(t *testing.T) {
function TestWithToolsetsIgnoresEmptyStrings (line 212) | func TestWithToolsetsIgnoresEmptyStrings(t *testing.T) {
function TestUnrecognizedToolsets (line 226) | func TestUnrecognizedToolsets(t *testing.T) {
function TestBuildErrorsOnUnrecognizedTools (line 283) | func TestBuildErrorsOnUnrecognizedTools(t *testing.T) {
function TestWithTools (line 386) | func TestWithTools(t *testing.T) {
function TestChainedFilters (line 411) | func TestChainedFilters(t *testing.T) {
function TestToolsetIDs (line 431) | func TestToolsetIDs(t *testing.T) {
function TestToolsetDescriptions (line 451) | func TestToolsetDescriptions(t *testing.T) {
function TestToolsForToolset (line 469) | func TestToolsForToolset(t *testing.T) {
function TestWithDeprecatedAliases (line 484) | func TestWithDeprecatedAliases(t *testing.T) {
function TestResolveToolAliases (line 504) | func TestResolveToolAliases(t *testing.T) {
function TestFindToolByName (line 537) | func TestFindToolByName(t *testing.T) {
function TestWithToolsAdditive (line 563) | func TestWithToolsAdditive(t *testing.T) {
function TestWithToolsResolvesAliases (line 608) | func TestWithToolsResolvesAliases(t *testing.T) {
function TestHasToolset (line 630) | func TestHasToolset(t *testing.T) {
function TestEnabledToolsetIDs (line 645) | func TestEnabledToolsetIDs(t *testing.T) {
function TestAllTools (line 669) | func TestAllTools(t *testing.T) {
function TestServerToolIsReadOnly (line 690) | func TestServerToolIsReadOnly(t *testing.T) {
function mockResource (line 703) | func mockResource(name string, toolsetID string, uriTemplate string) Ser...
function mockPrompt (line 719) | func mockPrompt(name string, toolsetID string) ServerPrompt {
function TestForMCPRequest_Initialize (line 729) | func TestForMCPRequest_Initialize(t *testing.T) {
function TestForMCPRequest_ToolsList (line 756) | func TestForMCPRequest_ToolsList(t *testing.T) {
function TestForMCPRequest_ToolsCall (line 783) | func TestForMCPRequest_ToolsCall(t *testing.T) {
function TestForMCPRequest_ToolsCall_NotFound (line 802) | func TestForMCPRequest_ToolsCall_NotFound(t *testing.T) {
function TestForMCPRequest_ToolsCall_DeprecatedAlias (line 815) | func TestForMCPRequest_ToolsCall_DeprecatedAlias(t *testing.T) {
function TestForMCPRequest_ToolsCall_RespectsFilters (line 839) | func TestForMCPRequest_ToolsCall_RespectsFilters(t *testing.T) {
function TestForMCPRequest_ResourcesList (line 855) | func TestForMCPRequest_ResourcesList(t *testing.T) {
function TestForMCPRequest_ResourcesRead (line 881) | func TestForMCPRequest_ResourcesRead(t *testing.T) {
function TestForMCPRequest_PromptsList (line 897) | func TestForMCPRequest_PromptsList(t *testing.T) {
function TestForMCPRequest_PromptsGet (line 923) | func TestForMCPRequest_PromptsGet(t *testing.T) {
function TestForMCPRequest_UnknownMethod (line 941) | func TestForMCPRequest_UnknownMethod(t *testing.T) {
function TestForMCPRequest_DoesNotMutateOriginal (line 967) | func TestForMCPRequest_DoesNotMutateOriginal(t *testing.T) {
function TestForMCPRequest_ChainedWithOtherFilters (line 1005) | func TestForMCPRequest_ChainedWithOtherFilters(t *testing.T) {
function TestForMCPRequest_ResourcesTemplatesList (line 1046) | func TestForMCPRequest_ResourcesTemplatesList(t *testing.T) {
function TestMCPMethodConstants (line 1066) | func TestMCPMethodConstants(t *testing.T) {
function mockToolWithFlags (line 1090) | func mockToolWithFlags(name string, toolsetID string, readOnly bool, ena...
function TestFeatureFlagEnable (line 1097) | func TestFeatureFlagEnable(t *testing.T) {
function TestFeatureFlagDisable (line 1132) | func TestFeatureFlagDisable(t *testing.T) {
function TestFeatureFlagBoth (line 1159) | func TestFeatureFlagBoth(t *testing.T) {
function TestFeatureFlagError (line 1187) | func TestFeatureFlagError(t *testing.T) {
function TestFeatureFlagResources (line 1203) | func TestFeatureFlagResources(t *testing.T) {
function TestFeatureFlagPrompts (line 1228) | func TestFeatureFlagPrompts(t *testing.T) {
function TestServerToolHasHandler (line 1253) | func TestServerToolHasHandler(t *testing.T) {
function TestServerToolHandlerPanicOnNil (line 1270) | func TestServerToolHandlerPanicOnNil(t *testing.T) {
function TestServerToolEnabled (line 1286) | func TestServerToolEnabled(t *testing.T) {
function TestServerToolEnabledWithContext (line 1351) | func TestServerToolEnabledWithContext(t *testing.T) {
function TestBuilderWithFilter (line 1386) | func TestBuilderWithFilter(t *testing.T) {
function TestBuilderWithMultipleFilters (line 1415) | func TestBuilderWithMultipleFilters(t *testing.T) {
function TestBuilderFilterError (line 1457) | func TestBuilderFilterError(t *testing.T) {
function TestBuilderFilterWithContext (line 1478) | func TestBuilderFilterWithContext(t *testing.T) {
function TestEnabledAndFeatureFlagInteraction (line 1520) | func TestEnabledAndFeatureFlagInteraction(t *testing.T) {
function TestEnabledAndBuilderFilterInteraction (line 1563) | func TestEnabledAndBuilderFilterInteraction(t *testing.T) {
function TestAllFiltersInteraction (line 1585) | func TestAllFiltersInteraction(t *testing.T) {
function TestFilteredTools (line 1630) | func TestFilteredTools(t *testing.T) {
function TestFilteredToolsMatchesAvailableTools (line 1659) | func TestFilteredToolsMatchesAvailableTools(t *testing.T) {
function TestFilteringOrder (line 1693) | func TestFilteringOrder(t *testing.T) {
function TestForMCPRequest_ToolsCall_FeatureFlaggedVariants (line 1741) | func TestForMCPRequest_ToolsCall_FeatureFlaggedVariants(t *testing.T) {
function TestWithTools_DeprecatedAliasAndFeatureFlag (line 1793) | func TestWithTools_DeprecatedAliasAndFeatureFlag(t *testing.T) {
function mockToolWithMeta (line 1837) | func mockToolWithMeta(name string, toolsetID string, meta map[string]any...
function TestWithInsidersMode_DisabledStripsUIMetadata (line 1856) | func TestWithInsidersMode_DisabledStripsUIMetadata(t *testing.T) {
function TestWithInsidersMode_EnabledPreservesUIMetadata (line 1877) | func TestWithInsidersMode_EnabledPreservesUIMetadata(t *testing.T) {
function TestWithInsidersMode_EnabledPreservesInsidersOnlyTools (line 1902) | func TestWithInsidersMode_EnabledPreservesInsidersOnlyTools(t *testing.T) {
function TestWithInsidersMode_DisabledRemovesInsidersOnlyTools (line 1920) | func TestWithInsidersMode_DisabledRemovesInsidersOnlyTools(t *testing.T) {
function TestWithInsidersMode_ToolsWithoutUIMetaUnaffected (line 1936) | func TestWithInsidersMode_ToolsWithoutUIMetaUnaffected(t *testing.T) {
function TestWithInsidersMode_UIOnlyMetaBecomesNil (line 1976) | func TestWithInsidersMode_UIOnlyMetaBecomesNil(t *testing.T) {
function TestStripInsidersMetaFromTool (line 1994) | func TestStripInsidersMetaFromTool(t *testing.T) {
function TestStripInsidersFeatures (line 2053) | func TestStripInsidersFeatures(t *testing.T) {
function TestStripInsidersFeatures_RemovesInsidersOnlyTools (line 2075) | func TestStripInsidersFeatures_RemovesInsidersOnlyTools(t *testing.T) {
function TestInsidersOnlyMetaKeys_FutureAdditions (line 2092) | func TestInsidersOnlyMetaKeys_FutureAdditions(t *testing.T) {
function TestWithInsidersMode_DoesNotMutateOriginalTools (line 2120) | func TestWithInsidersMode_DoesNotMutateOriginalTools(t *testing.T) {
function TestWithExcludeTools (line 2133) | func TestWithExcludeTools(t *testing.T) {
function TestWithExcludeTools_OverridesAdditionalTools (line 2221) | func TestWithExcludeTools_OverridesAdditionalTools(t *testing.T) {
function TestWithExcludeTools_CombinesWithReadOnly (line 2247) | func TestWithExcludeTools_CombinesWithReadOnly(t *testing.T) {
function TestCreateExcludeToolsFilter (line 2266) | func TestCreateExcludeToolsFilter(t *testing.T) {
FILE: pkg/inventory/resources.go
type ResourceHandlerFunc (line 8) | type ResourceHandlerFunc
type ServerResourceTemplate (line 11) | type ServerResourceTemplate struct
method HasHandler (line 28) | func (sr *ServerResourceTemplate) HasHandler() bool {
method Handler (line 34) | func (sr *ServerResourceTemplate) Handler(deps any) mcp.ResourceHandler {
function NewServerResourceTemplate (line 42) | func NewServerResourceTemplate(toolset ToolsetMetadata, resourceTemplate...
FILE: pkg/inventory/server_tool.go
type HandlerFunc (line 16) | type HandlerFunc
type ToolsetID (line 20) | type ToolsetID
type ToolsetMetadata (line 23) | type ToolsetMetadata struct
method Icons (line 41) | func (tm ToolsetMetadata) Icons() []mcp.Icon {
type ServerTool (line 50) | type ServerTool struct
method IsReadOnly (line 92) | func (st *ServerTool) IsReadOnly() bool {
method HasHandler (line 97) | func (st *ServerTool) HasHandler() bool {
method Handler (line 103) | func (st *ServerTool) Handler(deps any) mcp.ToolHandler {
method RegisterFunc (line 114) | func (st *ServerTool) RegisterFunc(s *mcp.Server, deps any) {
function NewServerTool (line 131) | func NewServerTool[In any, Out any](tool mcp.Tool, toolset ToolsetMetada...
function NewServerToolWithContextHandler (line 155) | func NewServerToolWithContextHandler[In any, Out any](tool mcp.Tool, too...
function NewServerToolFromHandler (line 178) | func NewServerToolFromHandler(tool mcp.Tool, toolset ToolsetMetadata, ha...
function NewServerToolWithRawContextHandler (line 188) | func NewServerToolWithRawContextHandler(tool mcp.Tool, toolset ToolsetMe...
FILE: pkg/lockdown/lockdown.go
type RepoAccessCache (line 17) | type RepoAccessCache struct
method SetLogger (line 103) | func (c *RepoAccessCache) SetLogger(logger *slog.Logger) {
method IsSafeContent (line 122) | func (c *RepoAccessCache) IsSafeContent(ctx context.Context, username,...
method getRepoAccessInfo (line 137) | func (c *RepoAccessCache) getRepoAccessInfo(ctx context.Context, usern...
method queryRepoAccessInfo (line 201) | func (c *RepoAccessCache) queryRepoAccessInfo(ctx context.Context, use...
method log (line 253) | func (c *RepoAccessCache) log(ctx context.Context, level slog.Level, m...
method logDebug (line 263) | func (c *RepoAccessCache) logDebug(ctx context.Context, msg string, at...
method isTrustedBot (line 267) | func (c *RepoAccessCache) isTrustedBot(username string) bool {
type repoAccessCacheEntry (line 26) | type repoAccessCacheEntry struct
type RepoAccessInfo (line 33) | type RepoAccessInfo struct
constant defaultRepoAccessTTL (line 40) | defaultRepoAccessTTL = 20 * time.Minute
constant defaultRepoAccessCacheKey (line 41) | defaultRepoAccessCacheKey = "repo-access-cache"
type RepoAccessOption (line 50) | type RepoAccessOption
function WithTTL (line 54) | func WithTTL(ttl time.Duration) RepoAccessOption {
function WithLogger (line 61) | func WithLogger(logger *slog.Logger) RepoAccessOption {
function WithCacheName (line 69) | func WithCacheName(name string) RepoAccessOption {
function GetInstance (line 81) | func GetInstance(client *githubv4.Client, opts ...RepoAccessOption) *Rep...
type CacheStats (line 110) | type CacheStats struct
function cacheKey (line 272) | func cacheKey(owner, repo string) string {
FILE: pkg/lockdown/lockdown_test.go
constant testOwner (line 15) | testOwner = "octo-org"
constant testRepo (line 16) | testRepo = "octo-repo"
constant testUser (line 17) | testUser = "octocat"
type repoAccessQuery (line 20) | type repoAccessQuery struct
type countingTransport (line 37) | type countingTransport struct
method RoundTrip (line 43) | func (c *countingTransport) RoundTrip(req *http.Request) (*http.Respon...
method CallCount (line 50) | func (c *countingTransport) CallCount() int {
function newMockRepoAccessCache (line 56) | func newMockRepoAccessCache(t *testing.T, ttl time.Duration) (*RepoAcces...
function TestRepoAccessCacheEvictsAfterTTL (line 95) | func TestRepoAccessCacheEvictsAfterTTL(t *testing.T) {
FILE: pkg/log/io.go
type IOLogger (line 11) | type IOLogger struct
method Read (line 29) | func (l *IOLogger) Read(p []byte) (n int, err error) {
method Write (line 41) | func (l *IOLogger) Write(p []byte) (n int, err error) {
method Close (line 49) | func (l *IOLogger) Close() error {
function NewIOLogger (line 20) | func NewIOLogger(r io.Reader, w io.Writer, logger *slog.Logger) *IOLogger {
FILE: pkg/log/io_test.go
function TestLoggedReadWriter (line 13) | func TestLoggedReadWriter(t *testing.T) {
function removeTimeAttr (line 60) | func removeTimeAttr(groups []string, a slog.Attr) slog.Attr {
FILE: pkg/octicons/octicons.go
function RequiredIcons (line 23) | func RequiredIcons() []string {
type Theme (line 38) | type Theme
constant ThemeLight (line 42) | ThemeLight Theme = "light"
constant ThemeDark (line 44) | ThemeDark Theme = "dark"
function DataURI (line 52) | func DataURI(name string, theme Theme) string {
function Icons (line 68) | func Icons(name string) []mcp.Icon {
FILE: pkg/octicons/octicons_test.go
function TestDataURI (line 11) | func TestDataURI(t *testing.T) {
function TestIcons (line 56) | func TestIcons(t *testing.T) {
function TestThemeConstants (line 102) | func TestThemeConstants(t *testing.T) {
function TestEmbeddedIconsExist (line 107) | func TestEmbeddedIconsExist(t *testing.T) {
FILE: pkg/raw/raw.go
type GetRawClientFn (line 13) | type GetRawClientFn
type Client (line 16) | type Client struct
method newRequest (line 28) | func (c *Client) newRequest(ctx context.Context, method string, urlStr...
method refURL (line 37) | func (c *Client) refURL(owner, repo, ref, path string) string {
method URLFromOpts (line 44) | func (c *Client) URLFromOpts(opts *ContentOpts, owner, repo, path stri...
method commitURL (line 55) | func (c *Client) commitURL(owner, repo, sha, path string) string {
method GetRawContent (line 65) | func (c *Client) GetRawContent(ctx context.Context, owner, repo, path ...
function NewClient (line 22) | func NewClient(client *gogithub.Client, rawURL *url.URL) *Client {
type ContentOpts (line 59) | type ContentOpts struct
FILE: pkg/raw/raw_test.go
type mockRawTransport (line 17) | type mockRawTransport struct
method RoundTrip (line 23) | func (m *mockRawTransport) RoundTrip(req *http.Request) (*http.Respons...
function TestGetRawContent (line 37) | func TestGetRawContent(t *testing.T) {
function TestUrlFromOpts (line 134) | func TestUrlFromOpts(t *testing.T) {
FILE: pkg/sanitize/sanitize.go
function Sanitize (line 14) | func Sanitize(input string) string {
function FilterInvisibleCharacters (line 23) | func FilterInvisibleCharacters(input string) string {
function FilterHTMLTags (line 38) | func FilterHTMLTags(input string) string {
function FilterCodeFenceMetadata (line 46) | func FilterCodeFenceMetadata(input string) string {
constant maxCodeFenceInfoLength (line 69) | maxCodeFenceInfoLength = 48
function sanitizeCodeFenceLine (line 71) | func sanitizeCodeFenceLine(line string, insideFence bool, expectedFenceL...
function hasNonWhitespace (line 125) | func hasNonWhitespace(segment string) bool {
function isSafeCodeFenceToken (line 134) | func isSafeCodeFenceToken(token string) bool {
function getPolicy (line 148) | func getPolicy() *bluemonday.Policy {
function shouldRemoveRune (line 176) | func shouldRemoveRune(r rune) bool {
FILE: pkg/sanitize/sanitize_test.go
function TestFilterInvisibleCharacters (line 9) | func TestFilterInvisibleCharacters(t *testing.T) {
function TestShouldRemoveRune (line 125) | func TestShouldRemoveRune(t *testing.T) {
function TestFilterHtmlTags (line 190) | func TestFilterHtmlTags(t *testing.T) {
function TestFilterCodeFenceMetadata (line 255) | func TestFilterCodeFenceMetadata(t *testing.T) {
function TestSanitizeRemovesInvisibleCodeFenceMetadata (line 296) | func TestSanitizeRemovesInvisibleCodeFenceMetadata(t *testing.T) {
FILE: pkg/scopes/fetcher.go
constant OAuthScopesHeader (line 16) | OAuthScopesHeader = "X-OAuth-Scopes"
constant DefaultFetchTimeout (line 19) | DefaultFetchTimeout = 10 * time.Second
type FetcherOptions (line 22) | type FetcherOptions struct
type FetcherInterface (line 32) | type FetcherInterface interface
type Fetcher (line 38) | type Fetcher struct
method FetchTokenScopes (line 65) | func (f *Fetcher) FetchTokenScopes(ctx context.Context, token string) ...
function NewFetcher (line 44) | func NewFetcher(apiHost utils.APIHostResolver, opts FetcherOptions) *Fet...
function ParseScopeHeader (line 106) | func ParseScopeHeader(header string) []string {
function FetchTokenScopes (line 124) | func FetchTokenScopes(ctx context.Context, token string) ([]string, erro...
function FetchTokenScopesWithHost (line 135) | func FetchTokenScopesWithHost(ctx context.Context, token string, apiHost...
FILE: pkg/scopes/fetcher_test.go
type testAPIHostResolver (line 15) | type testAPIHostResolver struct
method BaseRESTURL (line 19) | func (t testAPIHostResolver) BaseRESTURL(_ context.Context) (*url.URL,...
method GraphqlURL (line 22) | func (t testAPIHostResolver) GraphqlURL(_ context.Context) (*url.URL, ...
method UploadURL (line 25) | func (t testAPIHostResolver) UploadURL(_ context.Context) (*url.URL, e...
method RawURL (line 28) | func (t testAPIHostResolver) RawURL(_ context.Context) (*url.URL, erro...
method AuthorizationServerURL (line 31) | func (t testAPIHostResolver) AuthorizationServerURL(_ context.Context)...
function TestParseScopeHeader (line 35) | func TestParseScopeHeader(t *testing.T) {
function TestFetcher_FetchTokenScopes (line 86) | func TestFetcher_FetchTokenScopes(t *testing.T) {
function TestFetcher_DefaultOptions (line 188) | func TestFetcher_DefaultOptions(t *testing.T) {
function TestFetcher_CustomHTTPClient (line 202) | func TestFetcher_CustomHTTPClient(t *testing.T) {
function TestFetcher_CustomAPIHost (line 213) | func TestFetcher_CustomAPIHost(t *testing.T) {
function TestFetcher_ContextCancellation (line 222) | func TestFetcher_ContextCancellation(t *testing.T) {
FILE: pkg/scopes/map.go
type ToolScopeMap (line 6) | type ToolScopeMap
type ToolScopeInfo (line 9) | type ToolScopeInfo struct
method HasAcceptedScope (line 72) | func (t *ToolScopeInfo) HasAcceptedScope(userScopes ...string) bool {
method MissingScopes (line 91) | func (t *ToolScopeInfo) MissingScopes(userScopes ...string) []string {
method GetRequiredScopesSlice (line 122) | func (t *ToolScopeInfo) GetRequiredScopesSlice() []string {
function SetToolScopeMapFromInventory (line 22) | func SetToolScopeMapFromInventory(inv *inventory.Inventory) {
function SetGlobalToolScopeMap (line 28) | func SetGlobalToolScopeMap(m ToolScopeMap) {
function GetToolScopeMap (line 34) | func GetToolScopeMap() (ToolScopeMap, error) {
function GetToolScopeInfo (line 42) | func GetToolScopeInfo(toolName string) (*ToolScopeInfo, error) {
function GetToolScopeMapFromInventory (line 52) | func GetToolScopeMapFromInventory(inv *inventory.Inventory) ToolScopeMap {
FILE: pkg/scopes/map_test.go
function TestGetToolScopeMap (line 10) | func TestGetToolScopeMap(t *testing.T) {
function TestGetToolScopeInfo (line 31) | func TestGetToolScopeInfo(t *testing.T) {
function TestToolScopeInfo_HasAcceptedScope (line 50) | func TestToolScopeInfo_HasAcceptedScope(t *testing.T) {
function TestToolScopeInfo_MissingScopes (line 136) | func TestToolScopeInfo_MissingScopes(t *testing.T) {
FILE: pkg/scopes/scopes.go
type Scope (line 11) | type Scope
constant NoScope (line 15) | NoScope Scope = ""
constant Repo (line 18) | Repo Scope = "repo"
constant PublicRepo (line 21) | PublicRepo Scope = "public_repo"
constant ReadOrg (line 24) | ReadOrg Scope = "read:org"
constant WriteOrg (line 27) | WriteOrg Scope = "write:org"
constant AdminOrg (line 30) | AdminOrg Scope = "admin:org"
constant Gist (line 33) | Gist Scope = "gist"
constant Notifications (line 36) | Notifications Scope = "notifications"
constant ReadProject (line 39) | ReadProject Scope = "read:project"
constant Project (line 42) | Project Scope = "project"
constant SecurityEvents (line 45) | SecurityEvents Scope = "security_events"
constant User (line 48) | User Scope = "user"
constant ReadUser (line 51) | ReadUser Scope = "read:user"
constant UserEmail (line 54) | UserEmail Scope = "user:email"
constant ReadPackages (line 57) | ReadPackages Scope = "read:packages"
constant WritePackages (line 60) | WritePackages Scope = "write:packages"
type ScopeSet (line 76) | type ScopeSet
method ToSlice (line 88) | func (s ScopeSet) ToSlice() []Scope {
method ToStringSlice (line 100) | func (s ScopeSet) ToStringSlice() []string {
function NewScopeSet (line 79) | func NewScopeSet(scopes ...Scope) ScopeSet {
function ToStringSlice (line 110) | func ToStringSlice(scopes ...Scope) []string {
function ExpandScopes (line 123) | func ExpandScopes(required ...Scope) []string {
function expandScopeSet (line 157) | func expandScopeSet(scopes []string) map[string]bool {
function HasRequiredScopes (line 179) | func HasRequiredScopes(tokenScopes []string, acceptedScopes []string) bo...
FILE: pkg/scopes/scopes_test.go
function TestExpandScopes (line 10) | func TestExpandScopes(t *testing.T) {
function TestToStringSlice (line 110) | func TestToStringSlice(t *testing.T) {
function TestScopeHierarchy (line 141) | func TestScopeHierarchy(t *testing.T) {
function TestExpandScopeSet (line 154) | func TestExpandScopeSet(t *testing.T) {
function TestHasRequiredScopes (line 227) | func TestHasRequiredScopes(t *testing.T) {
FILE: pkg/tooldiscovery/search.go
type SearchResult (line 12) | type SearchResult struct
constant DefaultMaxSearchResults (line 19) | DefaultMaxSearchResults = 3
constant substringMatchScore (line 22) | substringMatchScore = 5
constant exactTokensMatchScore (line 23) | exactTokensMatchScore = 2.5
constant descriptionMatchScore (line 24) | descriptionMatchScore = 2
constant prefixMatchScore (line 25) | prefixMatchScore = 1.5
constant parameterMatchScore (line 26) | parameterMatchScore = 1
type SearchOptions (line 30) | type SearchOptions struct
function Search (line 38) | func Search(query string, options ...SearchOptions) ([]SearchResult, err...
function SearchTools (line 51) | func SearchTools(tools []mcp.Tool, query string, options ...SearchOption...
function scoreTool (line 101) | func scoreTool(
function getMaxResults (line 219) | func getMaxResults(options []SearchOptions) int {
function lowerInputPropertyNames (line 227) | func lowerInputPropertyNames(inputSchema any) []string {
type matchTracker (line 264) | type matchTracker struct
method Add (line 276) | func (m *matchTracker) Add(part string) {
method List (line 284) | func (m *matchTracker) List() []string {
function newMatchTracker (line 269) | func newMatchTracker(capacity int) *matchTracker {
function normalizedSimilarity (line 288) | func normalizedSimilarity(a, b string) float64 {
function splitTokens (line 304) | func splitTokens(s string) []string {
FILE: pkg/tooldiscovery/search_test.go
function TestSearchTools_EmptyQueryReturnsNil (line 11) | func TestSearchTools_EmptyQueryReturnsNil(t *testing.T) {
function TestSearchTools_FindsByName (line 17) | func TestSearchTools_FindsByName(t *testing.T) {
function TestSearchTools_FindsByParameterName_JSONSchema (line 29) | func TestSearchTools_FindsByParameterName_JSONSchema(t *testing.T) {
function TestSearchTools_FindsByParameterName_MapSchema (line 44) | func TestSearchTools_FindsByParameterName_MapSchema(t *testing.T) {
FILE: pkg/translations/translations.go
type TranslationHelperFunc (line 13) | type TranslationHelperFunc
function NullTranslationHelper (line 15) | func NullTranslationHelper(_ string, defaultValue string) string {
function TranslationHelper (line 19) | func TranslationHelper() (TranslationHelperFunc, func()) {
function DumpTranslationKeyMap (line 60) | func DumpTranslationKeyMap(translationKeyMap map[string]string) error {
FILE: pkg/utils/api.go
type APIHostResolver (line 12) | type APIHostResolver interface
type APIHost (line 20) | type APIHost struct
method BaseRESTURL (line 41) | func (a APIHost) BaseRESTURL(_ context.Context) (*url.URL, error) {
method GraphqlURL (line 45) | func (a APIHost) GraphqlURL(_ context.Context) (*url.URL, error) {
method UploadURL (line 49) | func (a APIHost) UploadURL(_ context.Context) (*url.URL, error) {
method RawURL (line 53) | func (a APIHost) RawURL(_ context.Context) (*url.URL, error) {
method AuthorizationServerURL (line 57) | func (a APIHost) AuthorizationServerURL(_ context.Context) (*url.URL, ...
function NewAPIHost (line 30) | func NewAPIHost(s string) (APIHostResolver, error) {
function newDotcomHost (line 61) | func newDotcomHost() (APIHost, error) {
function newGHECHost (line 97) | func newGHECHost(hostname string) (APIHost, error) {
function newGHESHost (line 142) | func newGHESHost(hostname string) (APIHost, error) {
function checkSubdomainIsolation (line 202) | func checkSubdomainIsolation(scheme, hostname string) bool {
function parseAPIHost (line 224) | func parseAPIHost(s string) (APIHost, error) {
FILE: pkg/utils/api_test.go
function TestParseAPIHost (line 10) | func TestParseAPIHost(t *testing.T) {
FILE: pkg/utils/result.go
function NewToolResultText (line 5) | func NewToolResultText(message string) *mcp.CallToolResult {
function NewToolResultError (line 15) | func NewToolResultError(message string) *mcp.CallToolResult {
function NewToolResultErrorFromErr (line 26) | func NewToolResultErrorFromErr(message string, err error) *mcp.CallToolR...
function NewToolResultResource (line 37) | func NewToolResultResource(message string, contents *mcp.ResourceContent...
function NewToolResultResourceLink (line 51) | func NewToolResultResourceLink(message string, link *mcp.ResourceLink) *...
FILE: pkg/utils/token.go
type TokenType (line 13) | type TokenType
constant TokenTypeUnknown (line 16) | TokenTypeUnknown TokenType = iota
constant TokenTypePersonalAccessToken (line 17) | TokenTypePersonalAccessToken
constant TokenTypeFineGrainedPersonalAccessToken (line 18) | TokenTypeFineGrainedPersonalAccessToken
constant TokenTypeOAuthAccessToken (line 19) | TokenTypeOAuthAccessToken
constant TokenTypeUserToServerGitHubAppToken (line 20) | TokenTypeUserToServerGitHubAppToken
constant TokenTypeServerToServerGitHubAppToken (line 21) | TokenTypeServerToServerGitHubAppToken
function ParseAuthorizationHeader (line 44) | func ParseAuthorizationHeader(req *http.Request) (tokenType TokenType, t...
FILE: ui/src/apps/get-me/App.tsx
type UserData (line 16) | interface UserData {
function AvatarWithFallback (line 32) | function AvatarWithFallback({ src, login, size }: { src?: string; login:...
function UserCard (line 65) | function UserCard({ user }: { user: UserData }) {
function GetMeApp (line 142) | function GetMeApp() {
FILE: ui/src/apps/issue-write/App.tsx
type IssueResult (line 20) | interface IssueResult {
function SuccessView (line 30) | function SuccessView({
function CreateIssueApp (line 117) | function CreateIssueApp() {
FILE: ui/src/apps/pr-write/App.tsx
type PRResult (line 25) | interface PRResult {
function SuccessView (line 34) | function SuccessView({
function CreatePRApp (line 119) | function CreatePRApp() {
FILE: ui/src/components/AppProvider.tsx
type AppProviderProps (line 5) | interface AppProviderProps {
function AppProvider (line 9) | function AppProvider({ children }: AppProviderProps) {
FILE: ui/src/components/MarkdownEditor.tsx
type IntrinsicElements (line 30) | interface IntrinsicElements {
type MarkdownEditorProps (line 71) | interface MarkdownEditorProps {
function MarkdownEditor (line 78) | function MarkdownEditor({
FILE: ui/src/hooks/useMcpApp.ts
type UseMcpAppOptions (line 6) | interface UseMcpAppOptions {
type UseMcpAppReturn (line 13) | interface UseMcpAppReturn {
function useMcpApp (line 21) | function useMcpApp({
FILE: ui/vite.config.ts
function renameOutput (line 14) | function renameOutput(): Plugin {
Condensed preview — 357 files, each showing path, character count, and a content snippet. Download the .json file or copy for the full structured content (2,722K chars).
[
{
"path": ".dockerignore",
"chars": 108,
"preview": ".github\n.vscode\nscript\nthird-party\n.dockerignore\n.gitignore\n**/*.yml\n**/*.yaml\n**/*.md\n**/*_test.go\nLICENSE\n"
},
{
"path": ".github/CODEOWNERS",
"chars": 28,
"preview": "* @github/github-mcp-server\n"
},
{
"path": ".github/ISSUE_TEMPLATE/bug_report.md",
"chars": 645,
"preview": "---\nname: \"\\U0001F41B Bug report\"\nabout: Report a bug or unexpected behavior while using GitHub MCP Server\ntitle: ''\nlab"
},
{
"path": ".github/ISSUE_TEMPLATE/feature_request.md",
"chars": 710,
"preview": "---\nname: \"⭐ Submit a feature request\"\nabout: Surface a feature or problem that you think should be solved\ntitle: ''\nlab"
},
{
"path": ".github/agents/go-sdk-tool-migrator.md",
"chars": 6241,
"preview": "---\nname: go-sdk-tool-migrator\ndescription: Agent specializing in migrating MCP tools from mark3labs/mcp-go to modelcont"
},
{
"path": ".github/copilot-instructions.md",
"chars": 12965,
"preview": "# GitHub MCP Server - Copilot Instructions\n\n## Project Overview\n\nThis is the **GitHub MCP Server**, a Model Context Prot"
},
{
"path": ".github/dependabot.yml",
"chars": 643,
"preview": "# To get started with Dependabot version updates, you'll need to specify which\n# package ecosystems to update and where "
},
{
"path": ".github/licenses.tmpl",
"chars": 443,
"preview": "# GitHub MCP Server dependencies\n\nThe following open source dependencies are used to build the [github/github-mcp-server"
},
{
"path": ".github/prompts/bug-report-review.prompt.yml",
"chars": 2228,
"preview": "messages:\n - role: system\n content: |\n You are a triage assistant for the GitHub MCP Server repository. This is"
},
{
"path": ".github/prompts/default-issue-review.prompt.yml",
"chars": 2676,
"preview": "messages:\n - role: system\n content: |\n You are a triage assistant for the GitHub MCP Server repository. This is"
},
{
"path": ".github/pull_request_template.md",
"chars": 1636,
"preview": "<!--\nCopilot: Fill all sections. Prefer short, concrete answers.\nIf a checkbox is selected, add a brief explanation.\n-->"
},
{
"path": ".github/workflows/ai-issue-assessment.yml",
"chars": 782,
"preview": "name: AI Issue Assessment\n\non:\n issues:\n types: [opened, labeled]\n\njobs:\n ai-issue-assessment:\n runs-on: ubuntu-"
},
{
"path": ".github/workflows/close-inactive-issues.yml",
"chars": 1154,
"preview": "name: Close inactive issues\non:\n schedule:\n - cron: \"30 8 * * *\"\n\njobs:\n close-issues:\n runs-on: ubuntu-latest\n "
},
{
"path": ".github/workflows/code-scanning.yml",
"chars": 3560,
"preview": "name: \"CodeQL\"\nrun-name: ${{ github.event.inputs.code_scanning_run_name }}\non: [push, pull_request, workflow_dispatch]\n\n"
},
{
"path": ".github/workflows/docker-publish.yml",
"chars": 5107,
"preview": "name: Docker\n\n# This workflow uses actions that are not certified by GitHub.\n# They are provided by a third-party and ar"
},
{
"path": ".github/workflows/docs-check.yml",
"chars": 1396,
"preview": "name: Documentation Check\n\non:\n push:\n branches: [ main ]\n pull_request:\n branches: [ main ]\n\npermissions:\n con"
},
{
"path": ".github/workflows/go.yml",
"chars": 1299,
"preview": "name: Build and Test Go Project\non: [push, pull_request]\n\npermissions:\n contents: read\n\njobs:\n build:\n strategy:\n "
},
{
"path": ".github/workflows/goreleaser.yml",
"chars": 1293,
"preview": "name: GoReleaser Release\non:\n push:\n tags:\n - \"v*\"\npermissions:\n contents: write\n id-token: write\n attestati"
},
{
"path": ".github/workflows/issue-labeler.yml",
"chars": 483,
"preview": "name: Label issues for AI review\non:\n issues:\n types:\n - reopened\n - opened\njobs:\n label_issues:\n runs"
},
{
"path": ".github/workflows/license-check.yml",
"chars": 4178,
"preview": "# Automatically fix license files on PRs that need updates\n# Tries to auto-commit the fix, or comments with instructions"
},
{
"path": ".github/workflows/lint.yml",
"chars": 644,
"preview": "name: golangci-lint\non:\n push:\n branches:\n - main\n pull_request:\n\npermissions:\n contents: read\n\njobs:\n golan"
},
{
"path": ".github/workflows/mcp-diff.yml",
"chars": 3756,
"preview": "name: MCP Server Diff\n\non:\n pull_request:\n push:\n branches: [main]\n tags: ['v*']\n\npermissions:\n contents: read\n"
},
{
"path": ".github/workflows/moderator.yml",
"chars": 663,
"preview": "name: AI Moderator\non:\n issues:\n types: [opened]\n issue_comment:\n types: [created]\n pull_request_review_comment"
},
{
"path": ".github/workflows/registry-releaser.yml",
"chars": 2757,
"preview": "name: Publish to MCP Registry\n\non:\n push:\n tags: [\"v*\"] # Triggers on version tags like v1.0.0\n workflow_dispatch:"
},
{
"path": ".gitignore",
"chars": 421,
"preview": ".idea\ncmd/github-mcp-server/github-mcp-server\n\n# VSCode\n.vscode/*\n!.vscode/launch.json\n\n# Added by goreleaser init:\ndist"
},
{
"path": ".golangci.yml",
"chars": 864,
"preview": "version: \"2\"\nrun:\n concurrency: 4\n tests: true\nlinters:\n enable:\n - bodyclose\n - gocritic\n - gosec\n - mak"
},
{
"path": ".goreleaser.yaml",
"chars": 960,
"preview": "version: 2\nproject_name: github-mcp-server\nbefore:\n hooks:\n - go mod tidy\n - go generate ./...\n\nbuilds:\n - env:\n"
},
{
"path": ".vscode/launch.json",
"chars": 1272,
"preview": "{\n // Use IntelliSense to learn about possible attributes.\n // Hover to view descriptions of existing attributes.\n"
},
{
"path": "CODE_OF_CONDUCT.md",
"chars": 5208,
"preview": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nWe as members, contributors, and leaders pledge to make participa"
},
{
"path": "CONTRIBUTING.md",
"chars": 3421,
"preview": "## Contributing\n\n[fork]: https://github.com/github/github-mcp-server/fork\n[pr]: https://github.com/github/github-mcp-ser"
},
{
"path": "Dockerfile",
"chars": 1632,
"preview": "FROM node:20-alpine@sha256:09e2b3d9726018aecf269bd35325f46bf75046a643a66d28360ec71132750ec8 AS ui-build\nWORKDIR /app\nCOP"
},
{
"path": "LICENSE",
"chars": 1063,
"preview": "MIT License\n\nCopyright (c) 2025 GitHub\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof "
},
{
"path": "README.md",
"chars": 85309,
"preview": "[](https://goreportcard.com/report/"
},
{
"path": "SECURITY.md",
"chars": 1744,
"preview": "Thanks for helping make GitHub safe for everyone.\n\n# Security\n\nGitHub takes the security of our software products and se"
},
{
"path": "SUPPORT.md",
"chars": 639,
"preview": "# Support\n\n## How to file issues and get help\n\nThis project uses GitHub issues to track bugs and feature requests. Pleas"
},
{
"path": "docs/error-handling.md",
"chars": 4605,
"preview": "# Error Handling\n\nThis document describes the error handling patterns used in the GitHub MCP Server, specifically how we"
},
{
"path": "docs/host-integration.md",
"chars": 13081,
"preview": "# GitHub Remote MCP Integration Guide for MCP Host Authors\n\nThis guide outlines high-level considerations for MCP Host a"
},
{
"path": "docs/insiders-features.md",
"chars": 2062,
"preview": "# Insiders Features\n\nInsiders Mode gives you access to experimental features in the GitHub MCP Server. These features ma"
},
{
"path": "docs/installation-guides/README.md",
"chars": 6434,
"preview": "# GitHub MCP Server Installation Guides\n\nThis directory contains detailed installation instructions for the GitHub MCP S"
},
{
"path": "docs/installation-guides/install-antigravity.md",
"chars": 4240,
"preview": "# Installing GitHub MCP Server in Antigravity\n\nThis guide covers setting up the GitHub MCP Server in Google's Antigravit"
},
{
"path": "docs/installation-guides/install-claude.md",
"chars": 7494,
"preview": "# Install GitHub MCP Server in Claude Applications\n\n## Claude Code CLI\n\n### Prerequisites\n- Claude Code CLI installed\n- "
},
{
"path": "docs/installation-guides/install-cline.md",
"chars": 2586,
"preview": "# Install GitHub MCP Server in Cline\n\n[Cline](https://github.com/cline/cline) is an AI coding assistant that runs in VS "
},
{
"path": "docs/installation-guides/install-codex.md",
"chars": 3822,
"preview": "# Install GitHub MCP Server in OpenAI Codex\n\n## Prerequisites\n\n1. OpenAI Codex (MCP-enabled) installed / available\n2. A "
},
{
"path": "docs/installation-guides/install-copilot-cli.md",
"chars": 4227,
"preview": "# Install GitHub MCP Server in Copilot CLI\n\nThe GitHub MCP server comes pre-installed in Copilot CLI, with read-only too"
},
{
"path": "docs/installation-guides/install-cursor.md",
"chars": 4285,
"preview": "# Install GitHub MCP Server in Cursor\n\n## Prerequisites\n\n1. Cursor IDE installed (latest version)\n2. [GitHub Personal Ac"
},
{
"path": "docs/installation-guides/install-gemini-cli.md",
"chars": 4900,
"preview": "# Install GitHub MCP Server in Google Gemini CLI\n\n## Prerequisites\n\n1. Google Gemini CLI installed (see [official Gemini"
},
{
"path": "docs/installation-guides/install-other-copilot-ides.md",
"chars": 8469,
"preview": "# Install GitHub MCP Server in Copilot IDEs\n\nQuick setup guide for the GitHub MCP server in GitHub Copilot across differ"
},
{
"path": "docs/installation-guides/install-roo-code.md",
"chars": 2081,
"preview": "# Install GitHub MCP Server in Roo Code\n\n[Roo Code](https://github.com/RooCodeInc/Roo-Code) is an AI coding assistant th"
},
{
"path": "docs/installation-guides/install-rovo-dev-cli.md",
"chars": 842,
"preview": "# Install GitHub MCP Server in Rovo Dev CLI\n\n## Prerequisites\n\n1. Rovo Dev CLI installed (latest version)\n2. [GitHub Per"
},
{
"path": "docs/installation-guides/install-windsurf.md",
"chars": 3492,
"preview": "# Install GitHub MCP Server in Windsurf\n\n## Prerequisites\n1. Windsurf IDE installed (latest version)\n2. [GitHub Personal"
},
{
"path": "docs/policies-and-governance.md",
"chars": 16464,
"preview": "# Policies & Governance for the GitHub MCP Server\n\nOrganizations and enterprises have several existing control mechanism"
},
{
"path": "docs/remote-server.md",
"chars": 25714,
"preview": "# Remote GitHub MCP Server 🚀\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=fl"
},
{
"path": "docs/scope-filtering.md",
"chars": 6273,
"preview": "# PAT Scope Filtering\n\nThe GitHub MCP Server automatically filters available tools based on your classic Personal Access"
},
{
"path": "docs/server-configuration.md",
"chars": 11627,
"preview": "# Server Configuration Guide\n\nThis guide helps you choose the right configuration for your use case and shows you how to"
},
{
"path": "docs/streamable-http.md",
"chars": 2859,
"preview": "# Streamable HTTP Server\n\nThe Streamable HTTP mode enables the GitHub MCP Server to run as an HTTP service, allowing cli"
},
{
"path": "docs/testing.md",
"chars": 2185,
"preview": "# Testing\n\nThis project uses a combination of unit tests and end-to-end (e2e) tests to ensure correctness and stability."
},
{
"path": "docs/tool-renaming.md",
"chars": 2783,
"preview": "# Tool Renaming Guide\n\nHow to safely rename MCP tools without breaking existing user configurations.\n\n## Overview\n\nWhen "
},
{
"path": "docs/toolsets-and-icons.md",
"chars": 6129,
"preview": "# Toolsets and Icons\n\nThis document explains how to work with toolsets and icons in the GitHub MCP Server.\n\n## Toolset O"
},
{
"path": "e2e/README.md",
"chars": 4664,
"preview": "# End To End (e2e) Tests\n\nThe purpose of the E2E tests is to have a simple (currently) test that gives maintainers some "
},
{
"path": "e2e/e2e_test.go",
"chars": 63471,
"preview": "//go:build e2e\n\npackage e2e_test\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"net/http\"\n\t\"os\"\n\t\"os/exec\"\n\t\"slices\"\n\t\"s"
},
{
"path": "gemini-extension.json",
"chars": 323,
"preview": "{\n\t\"name\": \"github\",\n\t\"version\": \"1.0.0\",\n\t\"mcpServers\": {\n\t\t\"github\": {\n\t\t\t\"description\": \"Connect AI assistants to Git"
},
{
"path": "go.mod",
"chars": 2168,
"preview": "module github.com/github/github-mcp-server\n\ngo 1.24.0\n\nrequire (\n\tgithub.com/go-chi/chi/v5 v5.2.5\n\tgithub.com/go-viper/m"
},
{
"path": "go.sum",
"chars": 12725,
"preview": "github.com/aymerick/douceur v0.2.0 h1:Mv+mAeH1Q+n9Fr+oyamOlAkUNPWPlA8PPGR0QAaYuPk=\ngithub.com/aymerick/douceur v0.2.0/go"
},
{
"path": "internal/ghmcp/server.go",
"chars": 12616,
"preview": "package ghmcp\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"io\"\n\t\"log/slog\"\n\t\"net/http\"\n\t\"os\"\n\t\"os/signal\"\n\t\"strings\"\n\t\"syscall\"\n\t\"time\""
},
{
"path": "internal/ghmcp/server_test.go",
"chars": 14,
"preview": "package ghmcp\n"
},
{
"path": "internal/githubv4mock/githubv4mock.go",
"chars": 7337,
"preview": "// githubv4mock package provides a mock GraphQL server used for testing queries produced via\n// shurcooL/githubv4 or shu"
},
{
"path": "internal/githubv4mock/local_round_tripper.go",
"chars": 1969,
"preview": "// Ths contents of this file are taken from https://github.com/shurcooL/graphql/blob/ed46e5a4646634fc16cb07c3b8db389542c"
},
{
"path": "internal/githubv4mock/objects_are_equal_values.go",
"chars": 3932,
"preview": "// The contents of this file are taken from https://github.com/stretchr/testify/blob/016e2e9c269209287f33ec203f340a9a723"
},
{
"path": "internal/githubv4mock/objects_are_equal_values_test.go",
"chars": 3037,
"preview": "// The contents of this file are taken from https://github.com/stretchr/testify/blob/016e2e9c269209287f33ec203f340a9a723"
},
{
"path": "internal/githubv4mock/query.go",
"chars": 5203,
"preview": "// Ths contents of this file are taken from https://github.com/shurcooL/graphql/blob/ed46e5a4646634fc16cb07c3b8db389542c"
},
{
"path": "internal/profiler/profiler.go",
"chars": 5610,
"preview": "package profiler\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"os\"\n\t\"runtime\"\n\t\"strconv\"\n\t\"time\"\n\n\t\"log/slog\"\n\t\"math\"\n)\n\n// Profile repr"
},
{
"path": "internal/toolsnaps/toolsnaps.go",
"chars": 3932,
"preview": "// Package toolsnaps provides test utilities for ensuring json schemas for tools\n// have not changed unexpectedly.\npacka"
},
{
"path": "internal/toolsnaps/toolsnaps_test.go",
"chars": 10189,
"preview": "package toolsnaps\n\nimport (\n\t\"encoding/json\"\n\t\"os\"\n\t\"path/filepath\"\n\t\"testing\"\n\n\t\"github.com/stretchr/testify/assert\"\n\t\""
},
{
"path": "pkg/buffer/buffer.go",
"chars": 3539,
"preview": "package buffer\n\nimport (\n\t\"bytes\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"strings\"\n)\n\n// maxLineSize is the maximum size for a single"
},
{
"path": "pkg/buffer/buffer_test.go",
"chars": 5644,
"preview": "package buffer\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"strings\"\n\t\"testing\"\n\n\t\"github.com/stretchr/testify/assert\"\n\t\"github."
},
{
"path": "pkg/context/graphql_features.go",
"chars": 580,
"preview": "package context\n\nimport \"context\"\n\n// graphQLFeaturesKey is a context key for GraphQL feature flags\ntype graphQLFeatures"
},
{
"path": "pkg/context/mcp_info.go",
"chars": 1569,
"preview": "package context\n\nimport \"context\"\n\ntype mcpMethodInfoCtx string\n\nvar mcpMethodInfoCtxKey mcpMethodInfoCtx = \"mcpmethodin"
},
{
"path": "pkg/context/request.go",
"chars": 4138,
"preview": "package context\n\nimport \"context\"\n\n// readonlyCtxKey is a context key for read-only mode\ntype readonlyCtxKey struct{}\n\n/"
},
{
"path": "pkg/context/token.go",
"chars": 1065,
"preview": "package context\n\nimport (\n\t\"context\"\n\n\t\"github.com/github/github-mcp-server/pkg/utils\"\n)\n\ntype tokenCtxKey struct{}\n\ntyp"
},
{
"path": "pkg/errors/error.go",
"chars": 7065,
"preview": "package errors\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"net/http\"\n\n\t\"github.com/github/github-mcp-server/pkg/utils\"\n\t\"github.com/go"
},
{
"path": "pkg/errors/error_test.go",
"chars": 16667,
"preview": "package errors\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/google/go-github/v82/github\"\n\t\"github.co"
},
{
"path": "pkg/github/__toolsnaps__/actions_get.snap",
"chars": 1591,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get details of GitHub Actions resources (workflows, workflo"
},
{
"path": "pkg/github/__toolsnaps__/actions_list.snap",
"chars": 4136,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List GitHub Actions workflows in a repository\"\n },\n \"desc"
},
{
"path": "pkg/github/__toolsnaps__/actions_run_trigger.snap",
"chars": 1592,
"preview": "{\n \"annotations\": {\n \"destructiveHint\": true,\n \"title\": \"Trigger GitHub Actions workflow actions\"\n },\n \"descrip"
},
{
"path": "pkg/github/__toolsnaps__/add_comment_to_pending_review.snap",
"chars": 2153,
"preview": "{\n \"annotations\": {\n \"title\": \"Add review comment to the requester's latest pending pull request review\"\n },\n \"des"
},
{
"path": "pkg/github/__toolsnaps__/add_issue_comment.snap",
"chars": 900,
"preview": "{\n \"annotations\": {\n \"title\": \"Add comment to issue\"\n },\n \"description\": \"Add a comment to a specific issue in a G"
},
{
"path": "pkg/github/__toolsnaps__/add_reply_to_pull_request_comment.snap",
"chars": 948,
"preview": "{\n \"annotations\": {\n \"title\": \"Add reply to pull request comment\"\n },\n \"description\": \"Add a reply to an existing "
},
{
"path": "pkg/github/__toolsnaps__/assign_copilot_to_issue.snap",
"chars": 3523,
"preview": "{\n \"annotations\": {\n \"idempotentHint\": true,\n \"title\": \"Assign Copilot to issue\"\n },\n \"description\": \"Assign Co"
},
{
"path": "pkg/github/__toolsnaps__/create_branch.snap",
"chars": 693,
"preview": "{\n \"annotations\": {\n \"title\": \"Create branch\"\n },\n \"description\": \"Create a new branch in a GitHub repository\",\n "
},
{
"path": "pkg/github/__toolsnaps__/create_gist.snap",
"chars": 735,
"preview": "{\n \"annotations\": {\n \"title\": \"Create Gist\"\n },\n \"description\": \"Create a new gist\",\n \"inputSchema\": {\n \"prope"
},
{
"path": "pkg/github/__toolsnaps__/create_issue.snap",
"chars": 1209,
"preview": "{\n \"annotations\": {\n \"title\": \"Open new issue\",\n \"readOnlyHint\": false\n },\n \"description\": \"Create a new issue "
},
{
"path": "pkg/github/__toolsnaps__/create_or_update_file.snap",
"chars": 1551,
"preview": "{\n \"annotations\": {\n \"title\": \"Create or update file\"\n },\n \"description\": \"Create or update a single file in a Git"
},
{
"path": "pkg/github/__toolsnaps__/create_pull_request.snap",
"chars": 1262,
"preview": "{\n \"_meta\": {\n \"ui\": {\n \"resourceUri\": \"ui://github-mcp-server/pr-write\",\n \"visibility\": [\n \"model\""
},
{
"path": "pkg/github/__toolsnaps__/create_repository.snap",
"chars": 872,
"preview": "{\n \"annotations\": {\n \"title\": \"Create repository\"\n },\n \"description\": \"Create a new GitHub repository in your acco"
},
{
"path": "pkg/github/__toolsnaps__/delete_file.snap",
"chars": 856,
"preview": "{\n \"annotations\": {\n \"destructiveHint\": true,\n \"title\": \"Delete file\"\n },\n \"description\": \"Delete a file from a"
},
{
"path": "pkg/github/__toolsnaps__/dismiss_notification.snap",
"chars": 598,
"preview": "{\n \"annotations\": {\n \"title\": \"Dismiss notification\"\n },\n \"description\": \"Dismiss a notification by marking it as "
},
{
"path": "pkg/github/__toolsnaps__/fork_repository.snap",
"chars": 2503,
"preview": "{\n \"annotations\": {\n \"title\": \"Fork repository\"\n },\n \"description\": \"Fork a GitHub repository to your account or s"
},
{
"path": "pkg/github/__toolsnaps__/get_code_scanning_alert.snap",
"chars": 681,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get code scanning alert\"\n },\n \"description\": \"Get details"
},
{
"path": "pkg/github/__toolsnaps__/get_commit.snap",
"chars": 1106,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get commit details\"\n },\n \"description\": \"Get details for "
},
{
"path": "pkg/github/__toolsnaps__/get_dependabot_alert.snap",
"chars": 672,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get dependabot alert\"\n },\n \"description\": \"Get details of"
},
{
"path": "pkg/github/__toolsnaps__/get_discussion.snap",
"chars": 604,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get discussion\"\n },\n \"description\": \"Get a specific discu"
},
{
"path": "pkg/github/__toolsnaps__/get_discussion_comments.snap",
"chars": 965,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get discussion comments\"\n },\n \"description\": \"Get comment"
},
{
"path": "pkg/github/__toolsnaps__/get_file_contents.snap",
"chars": 1005,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get file or directory contents\"\n },\n \"description\": \"Get "
},
{
"path": "pkg/github/__toolsnaps__/get_gist.snap",
"chars": 386,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get Gist Content\"\n },\n \"description\": \"Get gist content o"
},
{
"path": "pkg/github/__toolsnaps__/get_global_security_advisory.snap",
"chars": 439,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get a global security advisory\"\n },\n \"description\": \"Get "
},
{
"path": "pkg/github/__toolsnaps__/get_job_logs.snap",
"chars": 1236,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get job logs\"\n },\n \"description\": \"Download logs for a sp"
},
{
"path": "pkg/github/__toolsnaps__/get_label.snap",
"chars": 634,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get a specific label from a repository.\"\n },\n \"descriptio"
},
{
"path": "pkg/github/__toolsnaps__/get_latest_release.snap",
"chars": 494,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get latest release\"\n },\n \"description\": \"Get the latest r"
},
{
"path": "pkg/github/__toolsnaps__/get_me.snap",
"chars": 455,
"preview": "{\n \"_meta\": {\n \"ui\": {\n \"resourceUri\": \"ui://github-mcp-server/get-me\"\n }\n },\n \"annotations\": {\n \"readO"
},
{
"path": "pkg/github/__toolsnaps__/get_notification_details.snap",
"chars": 578,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get notification details\"\n },\n \"description\": \"Get detail"
},
{
"path": "pkg/github/__toolsnaps__/get_release_by_tag.snap",
"chars": 631,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get a release by tag name\"\n },\n \"description\": \"Get a spe"
},
{
"path": "pkg/github/__toolsnaps__/get_repository_tree.snap",
"chars": 1150,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get repository tree\"\n },\n \"description\": \"Get the tree st"
},
{
"path": "pkg/github/__toolsnaps__/get_secret_scanning_alert.snap",
"chars": 687,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get secret scanning alert\"\n },\n \"description\": \"Get detai"
},
{
"path": "pkg/github/__toolsnaps__/get_tag.snap",
"chars": 591,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get tag details\"\n },\n \"description\": \"Get details about a"
},
{
"path": "pkg/github/__toolsnaps__/get_team_members.snap",
"chars": 599,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get team members\"\n },\n \"description\": \"Get member usernam"
},
{
"path": "pkg/github/__toolsnaps__/get_teams.snap",
"chars": 451,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get teams\"\n },\n \"description\": \"Get details of the teams "
},
{
"path": "pkg/github/__toolsnaps__/issue_read.snap",
"chars": 1426,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get issue details\"\n },\n \"description\": \"Get information a"
},
{
"path": "pkg/github/__toolsnaps__/issue_write.snap",
"chars": 2531,
"preview": "{\n \"_meta\": {\n \"ui\": {\n \"resourceUri\": \"ui://github-mcp-server/issue-write\",\n \"visibility\": [\n \"mod"
},
{
"path": "pkg/github/__toolsnaps__/label_write.snap",
"chars": 1420,
"preview": "{\n \"annotations\": {\n \"title\": \"Write operations on repository labels.\"\n },\n \"description\": \"Perform write operatio"
},
{
"path": "pkg/github/__toolsnaps__/list_branches.snap",
"chars": 782,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List branches\"\n },\n \"description\": \"List branches in a Gi"
},
{
"path": "pkg/github/__toolsnaps__/list_code_scanning_alerts.snap",
"chars": 1339,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List code scanning alerts\"\n },\n \"description\": \"List code"
},
{
"path": "pkg/github/__toolsnaps__/list_commits.snap",
"chars": 1303,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List commits\"\n },\n \"description\": \"Get list of commits of"
},
{
"path": "pkg/github/__toolsnaps__/list_dependabot_alerts.snap",
"chars": 1021,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List dependabot alerts\"\n },\n \"description\": \"List dependa"
},
{
"path": "pkg/github/__toolsnaps__/list_discussion_categories.snap",
"chars": 618,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List discussion categories\"\n },\n \"description\": \"List dis"
},
{
"path": "pkg/github/__toolsnaps__/list_discussions.snap",
"chars": 1482,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List discussions\"\n },\n \"description\": \"List discussions f"
},
{
"path": "pkg/github/__toolsnaps__/list_gists.snap",
"chars": 789,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List Gists\"\n },\n \"description\": \"List gists for a user\",\n"
},
{
"path": "pkg/github/__toolsnaps__/list_global_security_advisories.snap",
"chars": 2269,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List global security advisories\"\n },\n \"description\": \"Lis"
},
{
"path": "pkg/github/__toolsnaps__/list_issue_types.snap",
"chars": 436,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List available issue types\"\n },\n \"description\": \"List sup"
},
{
"path": "pkg/github/__toolsnaps__/list_issues.snap",
"chars": 1881,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List issues\"\n },\n \"description\": \"List issues in a GitHub"
},
{
"path": "pkg/github/__toolsnaps__/list_label.snap",
"chars": 574,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List labels from a repository.\"\n },\n \"description\": \"List"
},
{
"path": "pkg/github/__toolsnaps__/list_notifications.snap",
"chars": 2202,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List notifications\"\n },\n \"description\": \"Lists all GitHub"
},
{
"path": "pkg/github/__toolsnaps__/list_org_repository_security_advisories.snap",
"chars": 1004,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List org repository security advisories\"\n },\n \"descriptio"
},
{
"path": "pkg/github/__toolsnaps__/list_pull_requests.snap",
"chars": 1652,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List pull requests\"\n },\n \"description\": \"List pull reques"
},
{
"path": "pkg/github/__toolsnaps__/list_releases.snap",
"chars": 782,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List releases\"\n },\n \"description\": \"List releases in a Gi"
},
{
"path": "pkg/github/__toolsnaps__/list_repository_security_advisories.snap",
"chars": 1121,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List repository security advisories\"\n },\n \"description\": "
},
{
"path": "pkg/github/__toolsnaps__/list_secret_scanning_alerts.snap",
"chars": 1233,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List secret scanning alerts\"\n },\n \"description\": \"List se"
},
{
"path": "pkg/github/__toolsnaps__/list_starred_repositories.snap",
"chars": 1181,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List starred repositories\"\n },\n \"description\": \"List star"
},
{
"path": "pkg/github/__toolsnaps__/list_tags.snap",
"chars": 774,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List tags\"\n },\n \"description\": \"List git tags in a GitHub"
},
{
"path": "pkg/github/__toolsnaps__/manage_notification_subscription.snap",
"chars": 733,
"preview": "{\n \"annotations\": {\n \"title\": \"Manage notification subscription\"\n },\n \"description\": \"Manage a notification subscr"
},
{
"path": "pkg/github/__toolsnaps__/manage_repository_notification_subscription.snap",
"chars": 910,
"preview": "{\n \"annotations\": {\n \"title\": \"Manage repository notification subscription\"\n },\n \"description\": \"Manage a reposito"
},
{
"path": "pkg/github/__toolsnaps__/mark_all_notifications_read.snap",
"chars": 770,
"preview": "{\n \"annotations\": {\n \"title\": \"Mark all notifications as read\"\n },\n \"description\": \"Mark all notifications as read"
},
{
"path": "pkg/github/__toolsnaps__/merge_pull_request.snap",
"chars": 2796,
"preview": "{\n \"annotations\": {\n \"title\": \"Merge pull request\"\n },\n \"description\": \"Merge a pull request in a GitHub repositor"
},
{
"path": "pkg/github/__toolsnaps__/projects_get.snap",
"chars": 1966,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get details of GitHub Projects resources\"\n },\n \"descripti"
},
{
"path": "pkg/github/__toolsnaps__/projects_list.snap",
"chars": 2262,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"List GitHub Projects resources\"\n },\n \"description\": \"Tool"
},
{
"path": "pkg/github/__toolsnaps__/projects_write.snap",
"chars": 3539,
"preview": "{\n \"annotations\": {\n \"destructiveHint\": true,\n \"title\": \"Modify GitHub Project items\"\n },\n \"description\": \"Add,"
},
{
"path": "pkg/github/__toolsnaps__/pull_request_read.snap",
"chars": 2495,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Get details for a single pull request\"\n },\n \"description\""
},
{
"path": "pkg/github/__toolsnaps__/pull_request_review_write.snap",
"chars": 2712,
"preview": "{\n \"annotations\": {\n \"title\": \"Write operations (create, submit, delete) on pull request reviews.\"\n },\n \"descripti"
},
{
"path": "pkg/github/__toolsnaps__/push_files.snap",
"chars": 1286,
"preview": "{\n \"annotations\": {\n \"title\": \"Push files to repository\"\n },\n \"description\": \"Push multiple files to a GitHub repo"
},
{
"path": "pkg/github/__toolsnaps__/request_copilot_review.snap",
"chars": 2803,
"preview": "{\n \"annotations\": {\n \"title\": \"Request Copilot review\"\n },\n \"description\": \"Request a GitHub Copilot code review f"
},
{
"path": "pkg/github/__toolsnaps__/search_code.snap",
"chars": 1320,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Search code\"\n },\n \"description\": \"Fast and precise code s"
},
{
"path": "pkg/github/__toolsnaps__/search_issues.snap",
"chars": 1718,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Search issues\"\n },\n \"description\": \"Search for issues in "
},
{
"path": "pkg/github/__toolsnaps__/search_orgs.snap",
"chars": 1265,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Search organizations\"\n },\n \"description\": \"Find GitHub or"
},
{
"path": "pkg/github/__toolsnaps__/search_pull_requests.snap",
"chars": 1756,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Search pull requests\"\n },\n \"description\": \"Search for pul"
},
{
"path": "pkg/github/__toolsnaps__/search_repositories.snap",
"chars": 1620,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Search repositories\"\n },\n \"description\": \"Find GitHub rep"
},
{
"path": "pkg/github/__toolsnaps__/search_users.snap",
"chars": 1295,
"preview": "{\n \"annotations\": {\n \"readOnlyHint\": true,\n \"title\": \"Search users\"\n },\n \"description\": \"Find GitHub users by u"
},
{
"path": "pkg/github/__toolsnaps__/star_repository.snap",
"chars": 1989,
"preview": "{\n \"annotations\": {\n \"title\": \"Star repository\"\n },\n \"description\": \"Star a GitHub repository\",\n \"icons\": [\n {"
},
{
"path": "pkg/github/__toolsnaps__/sub_issue_write.snap",
"chars": 1789,
"preview": "{\n \"annotations\": {\n \"title\": \"Change sub-issue\"\n },\n \"description\": \"Add a sub-issue to a parent issue in a GitHu"
},
{
"path": "pkg/github/__toolsnaps__/unstar_repository.snap",
"chars": 447,
"preview": "{\n \"annotations\": {\n \"title\": \"Unstar repository\"\n },\n \"description\": \"Unstar a GitHub repository\",\n \"inputSchema"
},
{
"path": "pkg/github/__toolsnaps__/update_gist.snap",
"chars": 697,
"preview": "{\n \"annotations\": {\n \"title\": \"Update Gist\"\n },\n \"description\": \"Update an existing gist\",\n \"inputSchema\": {\n "
},
{
"path": "pkg/github/__toolsnaps__/update_pull_request.snap",
"chars": 1474,
"preview": "{\n \"annotations\": {\n \"title\": \"Edit pull request\"\n },\n \"description\": \"Update an existing pull request in a GitHub"
},
{
"path": "pkg/github/__toolsnaps__/update_pull_request_branch.snap",
"chars": 777,
"preview": "{\n \"annotations\": {\n \"title\": \"Update pull request branch\"\n },\n \"description\": \"Update the branch of a pull reques"
},
{
"path": "pkg/github/actions.go",
"chars": 40226,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"errors\"\n\t\"fmt\"\n\t\"net/http\"\n\t\"strconv\"\n\t\"strings\"\n\n\t\"github.com/gi"
},
{
"path": "pkg/github/actions_test.go",
"chars": 20921,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/inter"
},
{
"path": "pkg/github/code_scanning.go",
"chars": 6547,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"io\"\n\t\"net/http\"\n\n\tghErrors \"github.com/github/github-mcp-server/p"
},
{
"path": "pkg/github/code_scanning_test.go",
"chars": 7991,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/inter"
},
{
"path": "pkg/github/context_tools.go",
"chars": 9727,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"time\"\n\n\tghErrors \"github.com/github/github-mcp-server/pkg/errors\""
},
{
"path": "pkg/github/context_tools_test.go",
"chars": 15785,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\t\"time\"\n\n\t\"github.com/github/github-mcp-serv"
},
{
"path": "pkg/github/copilot.go",
"chars": 21546,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"strings\"\n\t\"time\"\n\n\tghcontext \"github.com"
},
{
"path": "pkg/github/copilot_test.go",
"chars": 29046,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-serve"
},
{
"path": "pkg/github/dependabot.go",
"chars": 6061,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\n\tghErrors \"github.com/github/github-mcp-s"
},
{
"path": "pkg/github/dependabot_test.go",
"chars": 8022,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/inter"
},
{
"path": "pkg/github/dependencies.go",
"chars": 13771,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"errors\"\n\t\"fmt\"\n\t\"net/http\"\n\t\"os\"\n\n\tghcontext \"github.com/github/github-mcp-server/"
},
{
"path": "pkg/github/dependencies_test.go",
"chars": 2845,
"preview": "package github_test\n\nimport (\n\t\"context\"\n\t\"errors\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/pkg/github\"\n\t\"githu"
},
{
"path": "pkg/github/deprecated_tool_aliases.go",
"chars": 1740,
"preview": "// deprecated_tool_aliases.go\npackage github\n\n// DeprecatedToolAliases maps old tool names to their new canonical names."
},
{
"path": "pkg/github/discussions.go",
"chars": 19735,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\n\t\"github.com/github/github-mcp-server/pkg/inventory\"\n\t\"gith"
},
{
"path": "pkg/github/discussions_test.go",
"chars": 33030,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/inter"
},
{
"path": "pkg/github/dynamic_tools.go",
"chars": 8071,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\n\t\"github.com/github/github-mcp-server/pkg/inventory\"\n\t\"gith"
},
{
"path": "pkg/github/dynamic_tools_test.go",
"chars": 7118,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/pkg/inventory\"\n\t\""
},
{
"path": "pkg/github/feature_flags.go",
"chars": 158,
"preview": "package github\n\n// FeatureFlags defines runtime feature toggles that adjust tool behavior.\ntype FeatureFlags struct {\n\tL"
},
{
"path": "pkg/github/feature_flags_test.go",
"chars": 5761,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/pkg/translations\""
},
{
"path": "pkg/github/gists.go",
"chars": 11244,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\n\tghErrors \"github.com/github/github-mcp-s"
},
{
"path": "pkg/github/gists_test.go",
"chars": 18000,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\t\"time\"\n\n\t\"github.com/github/github-mcp-serv"
},
{
"path": "pkg/github/git.go",
"chars": 5620,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"strings\"\n\n\tghErrors \"github.com/github/github-mcp-server/p"
},
{
"path": "pkg/github/git_test.go",
"chars": 5624,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"strings\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-s"
},
{
"path": "pkg/github/helper_test.go",
"chars": 30741,
"preview": "package github\n\nimport (\n\t\"bytes\"\n\t\"context\"\n\t\"encoding/json\"\n\t\"io\"\n\t\"net/http\"\n\t\"net/url\"\n\t\"strings\"\n\t\"testing\"\n\n\t\"gith"
},
{
"path": "pkg/github/inventory.go",
"chars": 758,
"preview": "package github\n\nimport (\n\t\"github.com/github/github-mcp-server/pkg/inventory\"\n\t\"github.com/github/github-mcp-server/pkg/"
},
{
"path": "pkg/github/issues.go",
"chars": 52278,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"strings\"\n\t\"time\"\n\n\tghErrors \"github.com/"
},
{
"path": "pkg/github/issues_test.go",
"chars": 107507,
"preview": "package github\n\nimport (\n\t\"bytes\"\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"strings\"\n\t\"testing\"\n\t\"time\"\n\n\t\""
},
{
"path": "pkg/github/labels.go",
"chars": 13781,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"strings\"\n\n\tghErrors \"github.com/github/github-mcp-server/p"
},
{
"path": "pkg/github/labels_test.go",
"chars": 13330,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/internal/githubv4mock\""
},
{
"path": "pkg/github/minimal_types.go",
"chars": 29693,
"preview": "package github\n\nimport (\n\t\"time\"\n\n\t\"github.com/google/go-github/v82/github\"\n\n\t\"github.com/github/github-mcp-server/pkg/s"
},
{
"path": "pkg/github/notifications.go",
"chars": 22186,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"strconv\"\n\t\"time\"\n\n\tghErrors \"github.com/"
},
{
"path": "pkg/github/notifications_test.go",
"chars": 22894,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/inter"
},
{
"path": "pkg/github/params.go",
"chars": 14952,
"preview": "package github\n\nimport (\n\t\"errors\"\n\t\"fmt\"\n\t\"math\"\n\t\"strconv\"\n\n\t\"github.com/google/go-github/v82/github\"\n\t\"github.com/goo"
},
{
"path": "pkg/github/params_test.go",
"chars": 13692,
"preview": "package github\n\nimport (\n\t\"fmt\"\n\t\"math\"\n\t\"testing\"\n\n\t\"github.com/google/go-github/v82/github\"\n\t\"github.com/stretchr/test"
},
{
"path": "pkg/github/projects.go",
"chars": 49971,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"time\"\n\n\tghErrors \"github.com/github/gith"
},
{
"path": "pkg/github/projects_test.go",
"chars": 32055,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\n\t\"github.com/github/github-mcp-server/inter"
},
{
"path": "pkg/github/prompts.go",
"chars": 477,
"preview": "package github\n\nimport (\n\t\"github.com/github/github-mcp-server/pkg/inventory\"\n\t\"github.com/github/github-mcp-server/pkg/"
},
{
"path": "pkg/github/pullrequests.go",
"chars": 70397,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\n\t\"github.com/go-viper/mapstructure/v2\"\n\t\""
},
{
"path": "pkg/github/pullrequests_test.go",
"chars": 118323,
"preview": "package github\n\nimport (\n\t\"context\"\n\t\"encoding/json\"\n\t\"net/http\"\n\t\"testing\"\n\t\"time\"\n\n\t\"github.com/github/github-mcp-serv"
}
]
// ... and 157 more files (download for full content)
About this extraction
This page contains the full source code of the github/github-mcp-server GitHub repository, extracted and formatted as plain text for AI agents and large language models (LLMs). The extraction includes 357 files (2.3 MB), approximately 629.4k tokens, and a symbol index with 1476 extracted functions, classes, methods, constants, and types. Use this with OpenClaw, Claude, ChatGPT, Cursor, Windsurf, or any other AI tool that accepts text input. You can copy the full output to your clipboard or download it as a .txt file.
Extracted by GitExtract — free GitHub repo to text converter for AI. Built by Nikandr Surkov.