🏗️ Servidor MCP de GitHub Portfolio

Un servidor del Protocolo de Contexto de Modelos (MCP) que conecta Modelos de Lenguaje Extensos (como Claude) a la API de GitHub.

Este proyecto demuestra una comprensión de la infraestructura de IA mediante la construcción de un puente seguro y estandarizado entre la ventana de contexto de un LLM y una fuente de datos externa. Al utilizar el estándar MCP, el LLM puede solicitar datos en tiempo real de forma dinámica sin necesidad de integraciones de API personalizadas y únicas.

🧠 Descripción general de la arquitectura

Esta integración utiliza la arquitectura estándar MCP JSON-RPC sobre stdio:

1. El LLM / Cliente (p. ej., Claude Code): Actúa como el cerebro y el mediador. Lee los esquemas de las herramientas y decide cuándo obtener datos externos.

2. El servidor MCP (este repositorio): Una aplicación ligera de Python que utiliza el SDK mcp. Expone herramientas específicas de forma segura y maneja la comunicación JSON-RPC.

3. La API externa (GitHub): La fuente de datos. El servidor ejecuta solicitudes HTTP estándar para obtener datos en tiempo real.

🛠️ Herramientas disponibles

• fetch_public_repos: Toma un username de GitHub como cadena y devuelve una lista limpia y extraída de sus repositorios públicos (incluyendo nombre, URL y descripción) optimizada para la ventana de contexto de un LLM.

🚀 Inicio rápido

Requisitos previos

• Python 3.x instalado

• Claude Code (u otro cliente compatible con MCP)

Instalación

1. Clona este repositorio:

   git clone <your-repo-url>
   cd <your-repo-folder>```

2. Instala las dependencias necesarias: pip install -r requirements.txt

Ejecución con Claude Code

Puedes registrar fácilmente este servidor con Claude Code para que el LLM pueda usarlo de forma dinámica. Ejecuta el siguiente comando en tu terminal desde el directorio del proyecto:

claude mcp add github-portfolio python3 server.py

Una vez añadido, puedes pedirle a Claude Code algo como:

"Use the github-portfolio tools to fetch the public repositories for user1."

Claude formateará automáticamente la solicitud JSON-RPC, activará el servidor local de Python, ejecutará la llamada a la API y formateará la respuesta.

Pruebas locales

Si deseas probar el servidor sin Claude Code, se incluye un cliente de Python personalizado. Ejecuta:

python3 client.py

Esto iniciará un proceso en segundo plano, se conectará a través de la entrada/salida estándar y obtendrá una solicitud de prueba codificada.