🌐 Integração com API REST

A tool de listar repositórios usa a biblioteca httpx para fazer requests assíncronos à API do GitHub. O código essencial:

@server.tool()
async def list_repos(visibility: str = "all") -> str:
    """Lista repositórios do usuário autenticado."""
    async with httpx.AsyncClient() as client:
        resp = await client.get(
            "https://api.github.com/user/repos",
            headers={"Authorization": f"Bearer {GITHUB_TOKEN}"},
            params={"visibility": visibility, "sort": "updated"}
        )
        repos = resp.json()
    lines = []
    for r in repos:
        stars = r["stargazers_count"]
        lang = r.get("language", "N/A")
        lines.append(f"⭐ {stars} | {r['name']} ({lang}) — {r.get('description', 'Sem descrição')}")
    return "\n".join(lines)

A tool de buscar issues recebe owner (dono do repo), repo (nome do repositório) e parâmetros opcionais como state (open/closed/all) e labels (filtrar por etiquetas). O endpoint retorna um array JSON onde cada issue contém: number, title, user.login, state, labels[] e created_at. Formate a saída com número, título, autor e labels para facilitar a leitura.

A tool de criar issue envia um POST com body JSON contendo title (obrigatório) e body (descrição, opcional mas recomendado). Valide que o título não esteja vazio e tenha comprimento razoável. Após a criação, retorne a URL da issue criada para que o usuário possa acessá-la diretamente:

@server.tool()
async def create_issue(owner: str, repo: str, title: str, body: str = "") -> str:
    """Cria uma nova issue em um repositório GitHub."""
    if not title.strip():
        return "Erro: o título da issue não pode ser vazio."
    async with httpx.AsyncClient() as client:
        resp = await client.post(
            f"https://api.github.com/repos/{owner}/{repo}/issues",
            headers={"Authorization": f"Bearer {GITHUB_TOKEN}"},
            json={"title": title, "body": body}
        )
    if resp.status_code == 201:
        issue = resp.json()
        return f"Issue criada com sucesso! #{issue['number']}: {issue['html_url']}"
    return f"Erro ao criar issue: {resp.status_code}"

Teste com estes prompts no Claude Desktop:

• →"Liste meus repositórios" — deve chamar list_repos e exibir nome, linguagem, stars
• →"Quais issues abertas no repo X?" — deve chamar search_issues com state=open
• →"Crie uma issue no repo Y com título Z" — deve chamar create_issue e retornar a URL
• →"Quais repos privados eu tenho?" — deve chamar list_repos com visibility=private