🌐 Integración con API REST

La tool de listado de repositorios usa la biblioteca httpx para hacer requests asíncronos a la API de GitHub. El código esencial:

@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)

La tool de búsqueda de issues recibe owner (propietario del repo), repo (nombre del repositorio) y parámetros opcionales como state (open/closed/all) y labels (filtrar por etiquetas). El endpoint devuelve un array JSON donde cada issue contiene: number, title, user.login, state, labels[] e created_at. Da formato a la salida con número, título, autor y labels para facilitar la lectura.

La tool de creación de issues envía un POST con body JSON que contiene title (obligatorio) y body (descripción, opcional pero recomendada). Valida que el título no esté vacío y tenga una longitud razonable. Después de crearla, devuelve la URL de la issue creada para que el usuario pueda acceder directamente:

@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}"

Prueba con estos prompts en Claude Desktop:

• →"Lista mis repositorios" — debe llamar a list_repos y mostrar nombre, lenguaje, stars
• →"¿Qué issues abiertas hay en el repo X?" — debe llamar a search_issues con state=open
• →"Crea una issue en el repo Y con el título Z" — debe llamar a create_issue y devolver la URL
• →"¿Qué repos privados tengo?" — debe llamar a list_repos con visibility=private