GitHub MCP CLI con Ollama

Un proyecto de terminal que utiliza el Protocolo de Contexto de Modelo (MCP) y LLM locales (a través de Ollama) para consultar y resumir datos de GitHub.

Descripción general

Este proyecto se divide en dos componentes:

1. Servidor MCP (server.py): Creado con fastmcp, proporciona herramientas para obtener detalles de repositorios de GitHub, issues recientes y commits recientes.

2. Cliente CLI (client.py): Una interfaz de terminal interactiva que utiliza rich y LangChain para comunicarse con un modelo local de Ollama e interactuar con las herramientas MCP.

Related MCP server: GitHub MCP Server

Configuración

1. Instalar dependencias:

   pip install -r requirements.txt

2. Configurar el acceso a GitHub: Para aumentar los límites de tasa y acceder a repositorios privados, exporta tu token de acceso personal (PAT) de GitHub como variable de entorno (o colócalo en un archivo .env):

   export GITHUB_TOKEN="your_personal_access_token_here"

3. Iniciar Ollama: Asegúrate de que Ollama se esté ejecutando localmente con un modelo compatible con herramientas (como llama3.2):

   ollama run llama3.2

4. Ejecutar el cliente:

   python client.py

Desarrollo

Actualmente, tanto server.py como client.py son totalmente operativos. El cliente utiliza MultiServerMCPClient y el agente React de LangChain para conectarse sin problemas a las herramientas y enrutar tus preguntas a Ollama.

Herramientas expuestas por el servidor MCP:

• get_repo(owner, repo): Obtén detalles básicos sobre un repositorio.

• list_issues(owner, repo, state, limit): Obtén los issues recientes.

• list_commits(owner, repo, limit): Obtén los commits recientes.