Schema quality: 20 required parameters missing descriptions, 92 optional parameters undescribed
@RossTarrant がすでに取り組んでいます。
2026年6月1日 から。
評価
この issue はまだ評価されていません。
説明
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
bodyplain text or markdown? - What's the maximum length?
- Should
titleinclude 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
heada branch name or a ref likerefs/heads/feature? - Is
baserequired to bemainor 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.
- 主要言語
- Go
- スター
- 33.1k
- フォーク
- 5k
- 平均マージ
- 2日 1時間
- マージ済み PR（30日）
- 25
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
github/github-mcp-server のほかの issue
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
github/github-mcp-server#3235 ·
-
enhancement
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
github/github-mcp-server#3042 · コメント 2 件 ·
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
github/github-mcp-server#3032 · リアクション 1 件 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
github/github-mcp-server#2803 · コメント 1 件 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
github/github-mcp-server#2740 ·
github/github-mcp-server の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
NVIDIA/gpu-operator#2955 ·
-
agentic-workflows
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
-
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
kovidgoyal/kitty#10516 ·
-
bug
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
cisagov/vulnrichment#337 ·
-
難易度 1/5 1時間未満 初心者へのやさしさ 72/100