Schema quality: 20 required parameters missing descriptions, 92 optional parameters undescribed

Offen

#2,425 erstellt am 03.5.2026 0 Kommentare 0 Reaktionen 1 zugewiesene Person Auf GitHub ansehen

@RossTarrant arbeitet bereits daran.

Seit 01.6.2026.

Bewertung

Dieses Issue wurde noch nicht bewertet.

Beschreibung

Running static schema analysis on the GitHub MCP server reveals 112 issues (20 errors, 92 warnings) across 26 tools. The most impactful: required parameters with no description, which forces AI agents to guess what values to provide.

Summary:

Severity	Count	Impact
Error (E103)	20	Required parameters with no description
Warning (W102)	72	Optional parameters with no description
Warning (W103)	20	Required string params with no enum/pattern/example

Examples of what agents see:

create_issue requires title and body with no description. An agent doesn't know:

Is body plain text or markdown?
What's the maximum length?
Should title include a prefix like [BUG]?

search_repositories requires query with no description. An agent doesn't know:

Is this GitHub search syntax (language:go stars:>100)?
Or plain text?
What qualifiers are available?

create_pull_request requires title, body, head, base with no descriptions. An agent must guess:

Is head a branch name or a ref like refs/heads/feature?
Is base required to be main or can it be any branch?

What good parameter descriptions look like:

{
  "name": "query",
  "type": "string",
  "description": "GitHub search query using search syntax (e.g. 'language:go stars:>100'). See https://docs.github.com/en/search-github/searching-on-github"
}

How this was found:

mcp-assert lint --server "npx -y @modelcontextprotocol/server-github"

Adding descriptions to required parameters would significantly reduce agent misuse of these tools.

Vorherrschende Sprache: Go
Sterne: 33.1k
Forks: 5k
Ø Merge: 2 T. 1 Std.
Gemergte PRs (30 T.): 25

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus github/github-mcp-server

pull_request_read drops merge_commit_sha Offen

bug

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100

github/github-mcp-server#3235 · Erstellt am 07.9.2026
Add guidance on GitHub autolinked reference formatting for AI agents Offen

enhancement

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 88/100

github/github-mcp-server#3042 · 2 Kommentare · Erstellt am 08.8.2026
Incorrect install documentation leads to error "error: unknown option '-e'" Offen

bug

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100

github/github-mcp-server#3032 · 1 Reaktion · Erstellt am 06.8.2026
Document Kubernetes installation with the HelmForge Helm chart Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100

github/github-mcp-server#2803 · 1 Kommentar · Erstellt am 01.7.2026
get_discussion and get_discussion_comments accept calls with missing required parameters instead of returning a validation error Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100

github/github-mcp-server#2740 · Erstellt am 21.6.2026

Alle Issues in github/github-mcp-server