mcp-github-agent
mcp-agent
Многосервисный MCP-сервер (Model Context Protocol), который предоставляет AI-агенту доступ к 34 инструментам на 9 платформах — GitHub, Jira, Azure DevOps, Slack, PagerDuty, Linear, Notion, HuggingFace и OpenWeather.
Вместо переключения между вкладками и панелями управления вы общаетесь со своим AI-ассистентом на простом английском, и он напрямую запрашивает или выполняет действия в этих системах.
Работает с Claude, GPT-4o, Azure OpenAI и любым MCP-совместимым клиентом.
Что такое MCP?
Model Context Protocol — это открытый стандарт от Anthropic, который позволяет моделям ИИ взаимодействовать с внешними инструментами и API структурированным и безопасным способом. ИИ остаётся в диалоге, но может обращаться к реальным системам для получения данных или выполнения действий — самостоятельно решая, какие инструменты вызывать и в каком порядке.
→ Подробнее о том, как это работает
Related MCP server: GitHub MCP Server
Сервисы и инструменты
GitHub
Инструмент | Тип | Что делает |
| чтение | Био, местоположение, подписчики и количество публичных репозиториев |
| чтение | Публичные репозитории, отсортированные по активности, звёздам или дате |
| чтение | Звёзды, форки, открытые issues, темы, лицензия, последний push |
| чтение | Открытые или закрытые issues |
| чтение | Открытые или объединённые pull request'ы |
| чтение | Содержимое любого файла в репозитории |
| чтение | Топ-контрибьюторы по количеству коммитов |
| чтение | Последние релизы и журналы изменений |
| чтение | Трендовые репозитории по языку и периоду (ежедневно/еженедельно/ежемесячно) |
| чтение | Поиск по ключевому слову, теме или языку |
| запись | Создать новый issue (требуется область токена |
Jira
Инструмент | Тип | Что делает |
| чтение | Поиск issues с помощью JQL |
| чтение | Полные детали issue по ключу |
| чтение | Issues проекта, отфильтрованные по статусу |
| запись | Создать Task, Bug, Story или Epic |
Azure DevOps
Инструмент | Тип | Что делает |
| чтение | Список CI/CD пайплайнов в проекте |
| чтение | Последние запуски пайплайна |
| чтение | Поиск рабочих элементов по ключевому слову |
| запись | Создать Task, Bug, User Story или Epic |
Slack
Инструмент | Тип | Что делает |
| чтение | Список публичных каналов в рабочем пространстве |
| чтение | Чтение последних сообщений из канала |
| запись | Отправить сообщение в канал или пользователю |
PagerDuty
Инструмент | Тип | Что делает |
| чтение | Список инцидентов по статусу |
| чтение | Список настроенных сервисов |
| запись | Создать новый инцидент |
Linear
Инструмент | Тип | Что делает |
| чтение | Список команд в рабочем пространстве |
| чтение | Issues команды, отфильтрованные по статусу |
| запись | Создать issue в команде |
Notion
Инструмент | Тип | Что делает |
| чтение | Поиск страниц и баз данных по ключевому слову |
| чтение | Получить содержимое страницы |
| запись | Создать новую страницу под родительской |
HuggingFace
Инструмент | Тип | Что делает |
| чтение | Поиск моделей по ключевому слову и задаче |
| чтение | Подробная информация о модели (загрузки, лайки, теги) |
| чтение | Поиск датасетов по ключевому слову |
OpenWeather
Инструмент | Тип | Что делает |
| чтение | Текущая погода для города |
| чтение | Многодневный прогноз для города |
Примеры использования
Межсервисные рассуждения
"Проверь, есть ли открытые баги в Jira, связанные с сбоями нашего Azure DevOps пайплайна на этой неделе, затем создай issue в GitHub с их сводкой."
Агент вызывает jira_search_issues → ado_get_pipeline_runs → create_issue автономно.
Реагирование на инциденты
"Есть активный инцидент в PagerDuty на платёжном сервисе. Найди последний PR, объединённый в этот репозиторий, и уведоми канал #incidents в Slack."
Агент вызывает pagerduty_get_incidents → get_pull_requests → slack_send_message.
AI-исследования
"Найди самые скачиваемые модели генерации текста на HuggingFace, затем поищи на GitHub проекты, использующие лучшую из них."
Агент вызывает hf_search_models → search_repos.
Онбординг разработчиков
"Кто топ-5 контрибьюторов этого репозитория? Получи их профили GitHub и создай страницу в Notion с описанием команды."
Агент вызывает get_repo_contributors → get_user_profile (×5) → notion_create_page.
→ Больше примеров использования
Настройка
1. Клонируйте и установите
git clone https://github.com/Abdessamad-Y/mcp-github-agent.git
cd mcp-github-agent
pip install -r requirements.txt2. Настройте свои сервисы
cp .env.example .env
# Add tokens only for the services you want to use
# Unused services are safely ignored3. Подключите свой AI-клиент
→ См. docs/integrations.md для руководств по настройке:
Claude Desktop — нативный MCP, код не требуется
Claude API — Python-скрипт с агентским циклом
OpenAI (GPT-4o) — через SDK
openai-agentsAzure OpenAI — через OpenAI SDK + Azure endpoint
Cursor / VS Code Copilot
Запуск демо
GITHUB_TOKEN=your_token python demo.pyЗапускает 4 живых сценария с форматированным выводом в терминале. Ключ AI API не требуется.
Запуск примеров
# With Claude API
GITHUB_TOKEN=your_token ANTHROPIC_API_KEY=your_key python examples/with_claude.py
# With OpenAI
GITHUB_TOKEN=your_token OPENAI_API_KEY=your_key python examples/with_openai.py
# With Azure OpenAI
GITHUB_TOKEN=your_token \
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com \
AZURE_OPENAI_KEY=your_key \
AZURE_OPENAI_DEPLOYMENT=gpt-4o \
python examples/with_azure_openai.pyСтруктура проекта
mcp-github-agent/
├── server.py # Entry point — registers all tools
├── mcp_instance.py # Shared FastMCP instance
├── tools/
│ ├── github.py # 11 GitHub tools
│ ├── jira.py # 4 Jira tools
│ ├── azure_devops.py # 4 Azure DevOps tools
│ ├── slack.py # 3 Slack tools
│ ├── pagerduty.py # 3 PagerDuty tools
│ ├── linear.py # 3 Linear tools
│ ├── notion.py # 3 Notion tools
│ ├── huggingface.py # 3 HuggingFace tools
│ └── weather.py # 2 OpenWeather tools
├── examples/
│ ├── with_claude.py
│ ├── with_openai.py
│ └── with_azure_openai.py
├── docs/
│ ├── how-it-works.md
│ ├── use-cases.md
│ └── integrations.md
├── demo.py
├── requirements.txt
└── .env.exampleСтек
Язык | Python 3.10+ |
MCP SDK |
|
HTTP-клиент |
|
Вывод в терминал |
|
Документация
Архитектура, протокол MCP, транспорт | |
Реальные промпты и поведение агента | |
Настройка для Claude, OpenAI, Azure OpenAI, Cursor, VS Code |
Лицензия
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Access the GitHub API, enabling file operations, repository management, search functionality, and…
Ask any GitHub repository a question. Get source-backed answers.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to access and analyze GitHub profile data, providing insights on repositories, commit history, coding patterns, and generating portfolio summaries for developers and recruiters.82MIT
- FlicenseNot gradedqualityDmaintenanceEnables users to interact with GitHub via natural language requests, executing API calls and returning structured responses.-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform GitHub operations such as creating repositories, issues, pull requests, and more through natural language.-
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to answer natural-language GitHub queries by listing repositories, issues, pull requests, branches, commits, and files, as well as performing writes with dry-run and confirmation safeguards.-