Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

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

Aberta
#2,425 0 comentários 0 reações 1 responsável Ver no GitHub

@RossTarrant já está trabalhando nisso.

Desde 1/6/2026.

Avaliação

Esta issue ainda não foi avaliada.

Descrição

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.

Linguagem predominante
Go
Estrelas
33.1k
Forks
5k
Merge médio
2d 1h
PRs com merge (30d)
25

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de github/github-mcp-server

Todas as issues de github/github-mcp-server

Issues semelhantes

Mais issues de Go

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.