You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
chore: refactor repository references from github-mcp-server to github-mcp-http
- Updated import paths across multiple files to reflect the new repository name.
- Changed user agent strings and documentation links to use github-mcp-http.
- Adjusted test cases to reference the new repository.
- Modified configuration file names and paths for translations.
- Updated scripts to run commands against the new repository.
- Revised third-party licenses documentation to reflect the new repository.
Copy file name to clipboardExpand all lines: README.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# GitHub MCP Server - HTTP Streamable Transport
2
2
3
-
> **This is a fork** of the [official GitHub MCP Server](https://github.com/github/github-mcp-server). The official version only supports stdio transport. This fork implements **HTTP streamable transport with per-request OAuth authentication** for self-hosted enterprise deployments.
3
+
> **This is a fork** of the [official GitHub MCP Server](https://github.com/github/github-mcp-http). The official version only supports stdio transport. This fork implements **HTTP streamable transport with per-request OAuth authentication** for self-hosted enterprise deployments.
4
4
5
5
## Why This Fork?
6
6
@@ -54,8 +54,8 @@ The MCP server receives GitHub tokens from Pomerium and uses them to make API ca
54
54
### Build from source
55
55
56
56
```bash
57
-
go build -o github-mcp-server ./cmd/github-mcp-server
58
-
./github-mcp-server http --listen :8080
57
+
go build -o github-mcp-http ./cmd/github-mcp-http
58
+
./github-mcp-http http --listen :8080
59
59
```
60
60
61
61
**Important:** This server does NOT manage OAuth tokens. It requires an external OAuth proxy (like Pomerium) to:
@@ -76,7 +76,7 @@ Example Pomerium route configuration:
76
76
```yaml
77
77
routes:
78
78
- from: https://mcp.example.com
79
-
to: http://github-mcp-server:8080
79
+
to: http://github-mcp-http:8080
80
80
81
81
# Pomerium handles GitHub OAuth and injects tokens
82
82
upstream_oauth2:
@@ -824,7 +824,7 @@ The following sets of tools are available (all are on by default):
824
824
- `order`: Sort order for results (string, optional)
825
825
- `page`: Page number for pagination (min 1) (number, optional)
826
826
- `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
827
-
- `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)
827
+
- `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-http'. Supports exact matching, language filters, path filters, and more. (string, required)
828
828
- `sort`: Sort field ('indexed' only) (string, optional)
829
829
830
830
- **search_repositories** - Search repositories
@@ -943,12 +943,12 @@ To specify toolsets you want available to the LLM, you can pass an allow-list in
The environment variable `GITHUB_TOOLSETS` takes precedence over the command line argument if both are provided.
@@ -970,13 +970,13 @@ Note: This fork is designed to run behind an OAuth proxy like Pomerium. The MCP
970
970
The special toolset `all` can be provided to enable all available toolsets regardless of any other configuration:
971
971
972
972
```bash
973
-
./github-mcp-server --toolsets all
973
+
./github-mcp-http --toolsets all
974
974
```
975
975
976
976
Or using the environment variable:
977
977
978
978
```bash
979
-
GITHUB_TOOLSETS="all" ./github-mcp-server
979
+
GITHUB_TOOLSETS="all" ./github-mcp-http
980
980
```
981
981
982
982
## Dynamic Tool Discovery
@@ -992,7 +992,7 @@ Instead of starting with all tools enabled, you can turn on dynamic toolset disc
992
992
When using the binary, you can pass the `--dynamic-toolsets` flag.
993
993
994
994
```bash
995
-
./github-mcp-server --dynamic-toolsets
995
+
./github-mcp-http --dynamic-toolsets
996
996
```
997
997
998
998
When using Docker, you can pass the toolsets as environment variables:
@@ -1010,7 +1010,7 @@ To run the server in read-only mode, you can use the `--read-only` flag. This wi
1010
1010
> **Alternative with Pomerium**: Instead of using this hard-coded flag, you can use [Pomerium's dynamic authorization policies](https://www.pomerium.com/docs/capabilities/mcp#authorization-policies) to control which tools are accessible on a per-user or per-group basis, offering more flexibility than a global read-only mode.
1011
1011
1012
1012
```bash
1013
-
./github-mcp-server --read-only
1013
+
./github-mcp-http --read-only
1014
1014
```
1015
1015
1016
1016
When using Docker, you can pass the read-only mode as an environment variable:
@@ -1048,7 +1048,7 @@ the hostname for GitHub Enterprise Server or GitHub Enterprise Cloud with data r
1048
1048
## i18n / Overriding Descriptions
1049
1049
1050
1050
The descriptions of the tools can be overridden by creating a
1051
-
`github-mcp-server-config.json`file in the same directory as the binary.
1051
+
`github-mcp-http-config.json`file in the same directory as the binary.
1052
1052
1053
1053
The file should contain a JSON object with the tool names as keys and the new
1054
1054
descriptions as values. For example:
@@ -1068,8 +1068,8 @@ any new translations that have been added to the binary since the last time you
1068
1068
exported.
1069
1069
1070
1070
```sh
1071
-
./github-mcp-server --export-translations
1072
-
cat github-mcp-server-config.json
1071
+
./github-mcp-http --export-translations
1072
+
cat github-mcp-http-config.json
1073
1073
```
1074
1074
1075
1075
You can also use ENV vars to override the descriptions. The environment
@@ -1092,7 +1092,7 @@ The exported Go API of this module should currently be considered unstable, and
1092
1092
GitHub provides two official MCP server options:
1093
1093
1094
1094
1. **GitHub's Remote Server** (Closed-Source, Hosted) - Available at https:api.githubcopilot.com/mcp/, this is GitHub's official hosted HTTP MCP server with built-in OAuth support
1095
-
2. **GitHub's Open-Source Server** - The [official open-source repository](https://github.com/github/github-mcp-server) supports stdio transport only for local development with Personal Access Tokens (PATs)
1095
+
2. **GitHub's Open-Source Server** - The [official open-source repository](https://github.com/github/github-mcp-http) supports stdio transport only for local development with Personal Access Tokens (PATs)
1096
1096
1097
1097
This fork provides an open-source HTTP alternative for self-hosted enterprise deployments:
1098
1098
@@ -1111,7 +1111,7 @@ This fork provides an open-source HTTP alternative for self-hosted enterprise de
1111
1111
1112
1112
## Contributing
1113
1113
1114
-
This is a fork for demonstrating HTTP streamable transport with per-request OAuth. For issues with the core GitHub MCP functionality, please refer to the [official repository](https://github.com/github/github-mcp-server).
1114
+
This is a fork for demonstrating HTTP streamable transport with per-request OAuth. For issues with the core GitHub MCP functionality, please refer to the [official repository](https://github.com/github/github-mcp-http).
1115
1115
1116
1116
For issues specific to the HTTP transport implementation, feel free to open an issue in this repository.
1117
1117
@@ -1121,4 +1121,4 @@ This project is licensed under the terms of the MIT open source license. Please
1121
1121
1122
1122
## Acknowledgments
1123
1123
1124
-
This fork builds upon the excellent work by the GitHub team on the [official GitHub MCP Server](https://github.com/github/github-mcp-server). The HTTP streamable transport additions demonstrate patterns for enterprise MCP deployments with OAuth-based multi-user authentication and fine-grained authorization.
1124
+
This fork builds upon the excellent work by the GitHub team on the [official GitHub MCP Server](https://github.com/github/github-mcp-http). The HTTP streamable transport additions demonstrate patterns for enterprise MCP deployments with OAuth-based multi-user authentication and fine-grained authorization.
0 commit comments