Servidor MCP que dá a assistentes de IA acesso de leitura a repositórios do GitHub
Server has 8 tools with complete Zod schemas and descriptions in Portuguese. All tools are properly registered with input validation. However, descriptions are brief (avg 80 chars, below the 194-char baseline), lack WHEN/WHY context, and parameter descriptions are minimal. Output schemas are not documented. Error handling returns generic fail() responses without recovery guidance. No tool annotations (readOnlyHint/destructiveHint). Naming is clear and verb-based (list_, read_, create_, comment_, analyze_). Missing: pagination guidance, output field documentation, actionable error messages, and composition hints.
Faz um retrato completo de um repositorio: metadados, linguagens, atividade recente e issues abertas. Combina varias chamadas a API numa so resposta.
Adiciona um comentario a uma issue existente. Precisa de GITHUB_TOKEN com permissao de escrita.
Cria uma nova issue num repositorio. Precisa de GITHUB_TOKEN com permissao de escrita. Confirma com o utilizador antes de usar.
Mostra os commits mais recentes de um repositorio.
Lista todos os ficheiros de um repositorio, para saber o que existe antes de ler.
Lista as issues de um repositorio. Pull requests sao excluidos.
Descriptions lack WHEN/WHY context. E.g., 'Mostra os commits mais recentes' (shows recent commits) does not explain when to call it vs analyze_repo or why an agent should use it. LLMs need explicit selection guidance.
Output schemas are not documented. Tools return text responses via fail()/text() helpers, but the structure of returned data (fields, types, pagination) is invisible to LLMs. Agents cannot plan downstream calls or extract structured data.
Error handling is generic. fail() returns only the error message with isError=true. No recovery guidance, no categorization (retryable vs user-fixable vs fatal), no invalid-value echoing. LLMs cannot self-correct or plan recovery.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 67 | 2026-07-28+ | v2 |
Lista os repositorios publicos de um utilizador do GitHub, do mais recente para o mais antigo.
Le o conteudo de um ficheiro de um repositorio.
No tool annotations. create_issue and comment_on_issue are destructive (WRITE risk) but lack destructiveHint annotation. list_* tools are read-only but lack readOnlyHint. Agents cannot infer safety/idempotency without annotations.
Pagination not documented. list_repos, list_issues, list_commits accept limit but no offset/page/cursor. Responses capped at 200 items (list_files) but no next_cursor or total_count returned. Agents cannot iterate large result sets efficiently.