Nov 13, 2025 · Nov 13, 2025 · Nov 13, 2025 · Nov 13, 2025 · Nov 13, 2025 · Nov 13, 2025
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
 - **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:** Usesmark3labs/mcp-go for MCP protocol, google/go-github for GitHub API
 - **Framework:** Usesmodelcontextprotocol/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.

diff --git a/README.md b/README.md

 - **issue_read** - Get issue details
  - `issue_number`: The number of the issue (number, required)
  - `method`: The read operation to perform on a single issue.
 Options are:
  - `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.
  - `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.
 Options are:
 - 'create' - creates a new issue.
 - 'update' - updates an existing issue.
 (string, required)
  - `milestone`: Milestone number (number, optional)
 <summary>Notifications</summary>

 - **dismiss_notification** - Dismiss notification
  - `state`: The new state of the notification (read/done) (string,optional)
  - `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
diff --git a/cmd/github-mcp-server/generate_docs.go b/cmd/github-mcp-server/generate_docs.go
 "github.com/github/github-mcp-server/pkg/toolsets"
 "github.com/github/github-mcp-server/pkg/translations"
 gogithub "github.com/google/go-github/v79/github"
 "github.com/mark3labs/mcp-go/mcp"
 "github.com/google/jsonschema-go/jsonschema"
 "github.com/modelcontextprotocol/go-sdk/mcp"
 "github.com/shurcooL/githubv4"
 "github.com/spf13/cobra"
 )
 lines = append(lines, fmt.Sprintf("- **%s** - %s", tool.Name, tool.Annotations.Title))

 // Parameters
 schema := tool.InputSchema
 if tool.InputSchema == nil {
 lines = append(lines, "  - No parameters required")
 return strings.Join(lines, "\n")
 }
 schema, ok := tool.InputSchema.(*jsonschema.Schema)
 if !ok || schema == nil {
 lines = append(lines, "  - No parameters required")
 return strings.Join(lines, "\n")
 }

 if len(schema.Properties) > 0 {
 // Get parameter names and sort them for deterministic order
 var paramNames []string
 requiredStr = "required"
 }

 // Get the type and description
 typeStr := "unknown"
 description := ""

 if propMap, ok := prop.(map[string]interface{}); ok {
 if typeVal, ok := propMap["type"].(string); ok {
 if typeVal == "array" {
 if items, ok := propMap["items"].(map[string]interface{}); ok {
 if itemType, ok := items["type"].(string); ok {
 typeStr = itemType + "[]"
 }
 } else {
 typeStr = "array"
 }
 } else {
 typeStr = typeVal
 }
 }
 var typeStr, description string

 if desc, ok := propMap["description"].(string); ok {
 description = desc
 // Get the type and description
 switch prop.Type {
 case "array":
 if prop.Items != nil {
 typeStr = prop.Items.Type + "[]"
 } else {
 typeStr = "array"
 }
 default:
 typeStr = prop.Type
 }

 description = prop.Description

 paramLine := fmt.Sprintf("  - `%s`: %s (%s, %s)", propName, description, typeStr, requiredStr)
 lines = append(lines, paramLine)
 }
Original file line number	Diff line number	Diff line change
Expand Up		@@ -9,7 +9,7 @@ This is the GitHub MCP Server, a Model Context Protocol (MCP) server that co
		- 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: Usesmark3labs/mcp-go for MCP protocol, google/go-github for GitHub API
		- Framework: Usesmodelcontextprotocol/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.

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -717,8 +717,8 @@ The following sets of tools are available:

		- issue_read - Get issue details
		- `issue_number`: The number of the issue (number, required)
		- `method`: The read operation to perform on a single issue.
		Options are:
		- `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.
Expand All		@@ -736,8 +736,8 @@ Options are:
		- `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.
		Options are:
		- 'create' - creates a new issue.
		- 'update' - updates an existing issue.
		(string, required)
		- `milestone`: Milestone number (number, optional)
Expand DownExpand Up		@@ -817,7 +817,7 @@ Options are:
		<summary>Notifications</summary>

		- dismiss_notification - Dismiss notification
		- `state`: The new state of the notification (read/done) (string,optional)
		- `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
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -15,7 +15,8 @@ import (
		"github.com/github/github-mcp-server/pkg/toolsets"
		"github.com/github/github-mcp-server/pkg/translations"
		gogithub "github.com/google/go-github/v79/github"
		"github.com/mark3labs/mcp-go/mcp"
		"github.com/google/jsonschema-go/jsonschema"
		"github.com/modelcontextprotocol/go-sdk/mcp"
		"github.com/shurcooL/githubv4"
		"github.com/spf13/cobra"
		)
Expand DownExpand Up		@@ -226,7 +227,16 @@ func generateToolDoc(tool mcp.Tool) string {
		lines = append(lines, fmt.Sprintf("- %s - %s", tool.Name, tool.Annotations.Title))

		// Parameters
		schema := tool.InputSchema
		if tool.InputSchema == nil {
		lines = append(lines, " - No parameters required")
		return strings.Join(lines, "\n")
		}
		schema, ok := tool.InputSchema.(*jsonschema.Schema)
		if !ok \|\| schema == nil {
		lines = append(lines, " - No parameters required")
		return strings.Join(lines, "\n")
		}

		if len(schema.Properties) > 0 {
		// Get parameter names and sort them for deterministic order
		var paramNames []string
Expand All		@@ -243,30 +253,22 @@ func generateToolDoc(tool mcp.Tool) string {
		requiredStr = "required"
		}

		// Get the type and description
		typeStr := "unknown"
		description := ""

		if propMap, ok := prop.(map[string]interface{}); ok {
		if typeVal, ok := propMap["type"].(string); ok {
		if typeVal == "array" {
		if items, ok := propMap["items"].(map[string]interface{}); ok {
		if itemType, ok := items["type"].(string); ok {
		typeStr = itemType + "[]"
		}
		} else {
		typeStr = "array"
		}
		} else {
		typeStr = typeVal
		}
		}
		var typeStr, description string

		if desc, ok := propMap["description"].(string); ok {
		description = desc
		// Get the type and description
		switch prop.Type {
		case "array":
		if prop.Items != nil {
		typeStr = prop.Items.Type + "[]"
		} else {
		typeStr = "array"
		}
		default:
		typeStr = prop.Type
		}

		description = prop.Description

		paramLine := fmt.Sprintf(" - `%s`: %s (%s, %s)", propName, description, typeStr, requiredStr)
		lines = append(lines, paramLine)
		}
Expand Down