🏗️ MCP-сервер GitHub Portfolio

Сервер протокола контекста модели (MCP), который подключает большие языковые модели (например, Claude) к API GitHub.

Этот проект демонстрирует понимание инфраструктуры ИИ путем создания безопасного стандартизированного моста между контекстным окном LLM и внешним источником данных. Используя стандарт MCP, LLM может динамически запрашивать актуальные данные без необходимости в специальных одноразовых интеграциях API.

🧠 Обзор архитектуры

Эта интеграция использует стандартную архитектуру MCP JSON-RPC через stdio:

1. LLM / Клиент (например, Claude Code): Выступает в роли «мозга» и посредника. Он считывает схемы инструментов и решает, когда нужно получить внешние данные.

2. MCP-сервер (этот репозиторий): Легковесное приложение на Python, использующее SDK mcp. Оно безопасно предоставляет определенные инструменты и обрабатывает обмен данными по JSON-RPC.

3. Внешний API (GitHub): Источник данных. Сервер выполняет стандартные HTTP-запросы для получения актуальных данных.

🛠️ Доступные инструменты

• fetch_public_repos: Принимает username GitHub в виде строки и возвращает очищенный, извлеченный список их публичных репозиториев (включая имя, URL и описание), оптимизированный для контекстного окна LLM.

🚀 Быстрый старт

Предварительные требования

• Установленный Python 3.x

• Claude Code (или другой MCP-совместимый клиент)

Установка

1. Клонируйте этот репозиторий:

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

2. Установите необходимые зависимости: pip install -r requirements.txt

Запуск с Claude Code

Вы можете легко зарегистрировать этот сервер в Claude Code, чтобы LLM могла использовать его динамически. Выполните следующую команду в терминале из директории проекта:

claude mcp add github-portfolio python3 server.py

После добавления вы можете задать Claude Code запрос, например:

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

Claude автоматически отформатирует запрос JSON-RPC, запустит локальный Python-сервер, выполнит вызов API и отформатирует ответ.

Локальное тестирование

Если вы хотите протестировать сервер без Claude Code, в комплект включен пользовательский Python-клиент. Запустите:

python3 client.py

Это запустит фоновый процесс, подключится через стандартный ввод/вывод и выполнит жестко закодированный тестовый запрос.