feat: enable go run execution by moving main to root

- Move main.go to project root to enable `go run github.com/github/github-mcp-server@latest`
- Delegate execution to cmd/github-mcp-server package
- Update build configurations (Dockerfile, .goreleaser.yaml)
- Fix ldflags paths and import aliases
- Maintain backwards compatibility with existing cmd structure

Author: SchulteDev

.github/licenses.tmpl

@@ -10,4 +10,4 @@ Some packages may only be included on certain architectures or operating systems
  - [{{.Name}}](https://pkg.go.dev/{{.Name}}) ([{{.LicenseName}}]({{.LicenseURL}}))
 {{- end }}
 
-[github/github-mcp-server]: https://github.com/github/github-mcp-server
+[github/github-mcp-server]: https://github.com/SchulteDev/github_github-mcp-server

.github/workflows/docs-check.yml

@@ -22,7 +22,7 @@ jobs:
         go-version-file: 'go.mod'
 
     - name: Build docs generator
-      run: go build -o github-mcp-server ./cmd/github-mcp-server
+      run: go build -o github-mcp-server .
 
     - name: Generate documentation
       run: ./github-mcp-server generate-docs
@@ -35,7 +35,7 @@ jobs:
           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 "  go run . generate-docs"
           echo ""
           echo "Then commit the changes."
           echo ""

.github/workflows/go.yml

@@ -29,4 +29,4 @@ jobs:
         run: script/test
 
       - name: Build
-        run: go build -v ./cmd/github-mcp-server
+        run: go build -v .

.goreleaser.yaml

@@ -9,12 +9,12 @@ builds:
   - env:
       - CGO_ENABLED=0
     ldflags:
-      - -s -w -X main.version={{.Version}} -X main.commit={{.Commit}} -X main.date={{.Date}}
+      - -s -w -X github.com/SchulteDev/github_github-mcp-server/cmd/github-mcp-server.version={{.Version}} -X github.com/SchulteDev/github_github-mcp-server/cmd/github-mcp-server.commit={{.Commit}} -X github.com/SchulteDev/github_github-mcp-server/cmd/github-mcp-server.date={{.Date}}
     goos:
       - linux
       - windows
       - darwin
-    main: ./cmd/github-mcp-server
+    main: .
 
 archives:
   - formats: tar.gz

.vscode/launch.json

@@ -10,7 +10,7 @@
             "request": "launch",
             "mode": "auto",
             "cwd": "${workspaceFolder}",
-            "program": "cmd/github-mcp-server/main.go",
+            "program": "main.go",
             "args": ["stdio"],
             "console": "integratedTerminal",
         },
@@ -20,7 +20,7 @@
             "request": "launch",
             "mode": "auto",
             "cwd": "${workspaceFolder}",
-            "program": "cmd/github-mcp-server/main.go",
+            "program": "main.go",
             "args": ["stdio", "--read-only"],
             "console": "integratedTerminal",
         }

CONTRIBUTING.md

@@ -1,8 +1,8 @@
 ## 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
+[fork]: https://github.com/SchulteDev/github_github-mcp-server/fork
+[pr]: https://github.com/SchulteDev/github_github-mcp-server/compare
+[style]: https://github.com/SchulteDev/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.
 

Dockerfile

@@ -13,8 +13,8 @@ RUN --mount=type=cache,target=/var/cache/apk \
 RUN --mount=type=cache,target=/go/pkg/mod \
     --mount=type=cache,target=/root/.cache/go-build \
     --mount=type=bind,target=. \
-    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/main.go
+    CGO_ENABLED=0 go build -ldflags="-s -w -X github.com/SchulteDev/github_github-mcp-server/cmd/github-mcp-server.version=${VERSION} -X github.com/SchulteDev/github_github-mcp-server/cmd/github-mcp-server.commit=$(git rev-parse HEAD) -X github.com/SchulteDev/github_github-mcp-server/cmd/github-mcp-server.date=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+    -o /bin/github-mcp-server .
 
 # Make a stage to run the app
 FROM gcr.io/distroless/base-debian12

README.md

@@ -16,7 +16,7 @@ automation and interaction capabilities for developers and tools.
 
 [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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.
+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/SchulteDev/github_github-mcp-server?tab=readme-ov-file#local-github-mcp-server) instead.
 
 ## Prerequisites
 
@@ -234,8 +234,43 @@ More about using MCP server tools in VS Code's [agent mode documentation](https:
 
 ### 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:
+If you don't have Docker, you have several options:
+
+#### Option 1: Run directly from source (Recommended)
+
+You can run the server directly from source using `go run`:
+
+```bash
+GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> go run github.com/SchulteDev/github_github-mcp-server@latest stdio
+```
+
+Or configure your MCP host to use `go run`:
+
+```JSON
+{
+  "mcp": {
+    "servers": {
+      "github": {
+        "command": "go",
+        "args": ["run", "github.com/SchulteDev/github_github-mcp-server@latest", "stdio"],
+        "env": {
+          "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
+        }
+      }
+    }
+  }
+}
+```
+
+#### Option 2: Build and install
+
+You can build the binary and use the built executable:
+
+```bash
+go build -o github-mcp-server github.com/SchulteDev/github_github-mcp-server@latest
+```
+
+Then configure your server to use the built executable:
 
 ```JSON
 {

cmd/github-mcp-server/generate_docs.go

@@ -1,4 +1,4 @@
-package main
+package cmd
 
 import (
 	"context"
@@ -9,10 +9,10 @@ import (
 	"sort"
 	"strings"
 
-	"github.com/github/github-mcp-server/pkg/github"
-	"github.com/github/github-mcp-server/pkg/raw"
-	"github.com/github/github-mcp-server/pkg/toolsets"
-	"github.com/github/github-mcp-server/pkg/translations"
+	"github.com/SchulteDev/github_github-mcp-server/pkg/github"
+	"github.com/SchulteDev/github_github-mcp-server/pkg/raw"
+	"github.com/SchulteDev/github_github-mcp-server/pkg/toolsets"
+	"github.com/SchulteDev/github_github-mcp-server/pkg/translations"
 	gogithub "github.com/google/go-github/v72/github"
 	"github.com/mark3labs/mcp-go/mcp"
 	"github.com/shurcooL/githubv4"
@@ -29,7 +29,7 @@ var generateDocsCmd = &cobra.Command{
 }
 
 func init() {
-	rootCmd.AddCommand(generateDocsCmd)
+	RootCmd.AddCommand(generateDocsCmd)
 }
 
 // mockGetClient returns a mock GitHub client for documentation generation

cmd/github-mcp-server/main.go renamed to cmd/github-mcp-server/root_command.go

@@ -1,13 +1,12 @@
-package main
+package cmd
 
 import (
 	"errors"
 	"fmt"
-	"os"
 	"strings"
 
-	"github.com/github/github-mcp-server/internal/ghmcp"
-	"github.com/github/github-mcp-server/pkg/github"
+	"github.com/SchulteDev/github_github-mcp-server/internal/ghmcp"
+	"github.com/SchulteDev/github_github-mcp-server/pkg/github"
 	"github.com/spf13/cobra"
 	"github.com/spf13/pflag"
 	"github.com/spf13/viper"
@@ -19,7 +18,7 @@ var commit = "commit"
 var date = "date"
 
 var (
-	rootCmd = &cobra.Command{
+	RootCmd = &cobra.Command{
 		Use:     "server",
 		Short:   "GitHub MCP Server",
 		Long:    `A GitHub MCP server that handles various tools and resources.`,
@@ -63,30 +62,30 @@ var (
 
 func init() {
 	cobra.OnInitialize(initConfig)
-	rootCmd.SetGlobalNormalizationFunc(wordSepNormalizeFunc)
+	RootCmd.SetGlobalNormalizationFunc(wordSepNormalizeFunc)
 
-	rootCmd.SetVersionTemplate("{{.Short}}\n{{.Version}}\n")
+	RootCmd.SetVersionTemplate("{{.Short}}\n{{.Version}}\n")
 
 	// Add global flags that will be shared by all commands
-	rootCmd.PersistentFlags().StringSlice("toolsets", github.DefaultTools, "An optional comma separated list of groups of tools to allow, defaults to enabling all")
-	rootCmd.PersistentFlags().Bool("dynamic-toolsets", false, "Enable dynamic toolsets")
-	rootCmd.PersistentFlags().Bool("read-only", false, "Restrict the server to read-only operations")
-	rootCmd.PersistentFlags().String("log-file", "", "Path to log file")
-	rootCmd.PersistentFlags().Bool("enable-command-logging", false, "When enabled, the server will log all command requests and responses to the log file")
-	rootCmd.PersistentFlags().Bool("export-translations", false, "Save translations to a JSON file")
-	rootCmd.PersistentFlags().String("gh-host", "", "Specify the GitHub hostname (for GitHub Enterprise etc.)")
+	RootCmd.PersistentFlags().StringSlice("toolsets", github.DefaultTools, "An optional comma separated list of groups of tools to allow, defaults to enabling all")
+	RootCmd.PersistentFlags().Bool("dynamic-toolsets", false, "Enable dynamic toolsets")
+	RootCmd.PersistentFlags().Bool("read-only", false, "Restrict the server to read-only operations")
+	RootCmd.PersistentFlags().String("log-file", "", "Path to log file")
+	RootCmd.PersistentFlags().Bool("enable-command-logging", false, "When enabled, the server will log all command requests and responses to the log file")
+	RootCmd.PersistentFlags().Bool("export-translations", false, "Save translations to a JSON file")
+	RootCmd.PersistentFlags().String("gh-host", "", "Specify the GitHub hostname (for GitHub Enterprise etc.)")
 
 	// Bind flag to viper
-	_ = viper.BindPFlag("toolsets", rootCmd.PersistentFlags().Lookup("toolsets"))
-	_ = viper.BindPFlag("dynamic_toolsets", rootCmd.PersistentFlags().Lookup("dynamic-toolsets"))
-	_ = viper.BindPFlag("read-only", rootCmd.PersistentFlags().Lookup("read-only"))
-	_ = viper.BindPFlag("log-file", rootCmd.PersistentFlags().Lookup("log-file"))
-	_ = viper.BindPFlag("enable-command-logging", rootCmd.PersistentFlags().Lookup("enable-command-logging"))
-	_ = viper.BindPFlag("export-translations", rootCmd.PersistentFlags().Lookup("export-translations"))
-	_ = viper.BindPFlag("host", rootCmd.PersistentFlags().Lookup("gh-host"))
+	_ = viper.BindPFlag("toolsets", RootCmd.PersistentFlags().Lookup("toolsets"))
+	_ = viper.BindPFlag("dynamic_toolsets", RootCmd.PersistentFlags().Lookup("dynamic-toolsets"))
+	_ = viper.BindPFlag("read-only", RootCmd.PersistentFlags().Lookup("read-only"))
+	_ = viper.BindPFlag("log-file", RootCmd.PersistentFlags().Lookup("log-file"))
+	_ = viper.BindPFlag("enable-command-logging", RootCmd.PersistentFlags().Lookup("enable-command-logging"))
+	_ = viper.BindPFlag("export-translations", RootCmd.PersistentFlags().Lookup("export-translations"))
+	_ = viper.BindPFlag("host", RootCmd.PersistentFlags().Lookup("gh-host"))
 
 	// Add subcommands
-	rootCmd.AddCommand(stdioCmd)
+	RootCmd.AddCommand(stdioCmd)
 }
 
 func initConfig() {
@@ -96,13 +95,6 @@ func initConfig() {
 
 }
 
-func main() {
-	if err := rootCmd.Execute(); err != nil {
-		fmt.Fprintf(os.Stderr, "%v\n", err)
-		os.Exit(1)
-	}
-}
-
 func wordSepNormalizeFunc(_ *pflag.FlagSet, name string) pflag.NormalizedName {
 	from := []string{"_"}
 	to := "-"