Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở
#2,425 0 bình luận 0 reaction 1 người được giao Xem trên GitHub

@RossTarrant đang làm issue này rồi.

Từ ngày 1/6/2026.

Đánh giá

Issue này chưa được đánh giá.

Mô tả

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.

Ngôn ngữ chính
Go
Star
33.1k
Fork
5k
Merge trung bình
2 ngày 1 giờ
Pull request đã merge (30 ngày)
25

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của github/github-mcp-server

Tất cả issue của github/github-mcp-server

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.