GitHub Activity MCP Server
🚀 GitHub Activity MCP Server
MCP-сервер (Model Context Protocol), созданный на основе FastMCP и PyGithub, который подключает ИИ-ассистентов к GitHub — поиск репозиториев, управление issues и PR, анализ вклада и многое другое.
Что такое MCP? Model Context Protocol — это открытый стандарт, который позволяет ИИ-ассистентам подключаться к внешним данным и инструментам через единый интерфейс. Можно думать о нём как о «USB-C для ИИ».
✨ Возможности
Этот сервер предоставляет 13 инструментов, 3 провайдера ресурсов и 3 шаблона промптов — охватывая все три примитива MCP.
🔧 Инструменты (управляются моделью)
Действия, которые ИИ может выполнять автономно:
Tool | Описание |
| Поиск репозиториев GitHub по запросу, языку, звёздам |
| Получение подробной информации о репозитории (звёзды, форки, темы и т. д.) |
| Чтение любого файла из репозитория |
| Список последних коммитов с фильтрами |
| Список issues с фильтрами по статусу, метке, исполнителю |
| Полное содержимое issue + комментарии |
| Создание нового issue |
| Добавление комментария к issue |
| Список PR с фильтрами по статусу/ветке |
| Информация о PR + статус слияния |
| Просмотр изменений кода в PR |
| Публичный профиль пользователя |
| Список репозиториев пользователя |
📦 Ресурсы (управляются приложением)
Контекстные данные, которые ИИ может читать:
URI ресурса | Описание |
| README репозитория (Markdown) |
| Полное дерево файлов |
| Распределение по языкам в процентах |
💬 Промпты (запускаются пользователем)
Готовые шаблоны рабочих процессов:
Промпт | Описание |
| Комплексный анализ репозитория |
| Ревью кода с учётом лучших практик |
| Категоризация и приоритизация открытых issues |
Related MCP server: GitHub MCP Server
🏗️ Архитектура
graph LR
A[AI Assistant] <-->|MCP Protocol| B[GitHub MCP Server]
B <-->|REST API| C[GitHub API]
subgraph "MCP Server (FastMCP)"
B --> D[Tools]
B --> E[Resources]
B --> F[Prompts]
end
subgraph "Tools"
D --> D1[Repos]
D --> D2[Issues]
D --> D3[Pull Requests]
D --> D4[Users]
end🚀 Быстрый старт
Предварительные требования
Python версии 3.10 или выше
GitHub Personal Access Token (необязательно, но рекомендуется для более высоких лимитов)
Установка
# Clone the repository
git clone https://github.com/YOUR_USERNAME/github-mcp-server.git
cd github-mcp-server
# Install dependencies
pip install fastmcp PyGithubНастройка GitHub-токена (необязательно)
Создайте Personal Access Token с правами repo и read:user:
# Linux/macOS
export GITHUB_TOKEN=ghp_your_token_here
# Windows (PowerShell)
$env:GITHUB_TOKEN = "ghp_your_token_here"Примечание: Без токена вы ограничены 60 API-запросами в час. С токеном — 5 000 запросов в час.
Запуск сервера
# Run directly
fastmcp run src/server.py
# Or with Python
python -m src.serverТестирование с FastMCP Dev Mode
fastmcp dev src/server.py⚙️ Конфигурация
Claude Desktop
Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows):
{
"mcpServers": {
"github": {
"command": "fastmcp",
"args": ["run", "src/server.py"],
"cwd": "/absolute/path/to/github-mcp-server",
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}Cursor
Добавьте в конфигурацию MCP в Cursor (.cursor/mcp.json в вашем проекте или в глобальной конфигурации):
{
"mcpServers": {
"github": {
"command": "fastmcp",
"args": ["run", "src/server.py"],
"cwd": "/absolute/path/to/github-mcp-server",
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}VS Code (GitHub Copilot)
Добавьте в настройки VS Code (.vscode/settings.json):
{
"mcp": {
"servers": {
"github": {
"command": "fastmcp",
"args": ["run", "src/server.py"],
"cwd": "/absolute/path/to/github-mcp-server",
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}
}📁 Структура проекта
github-mcp-server/
├── src/
│ ├── __init__.py
│ ├── server.py # FastMCP server instance & entry point
│ ├── github_client.py # PyGithub client wrapper & error handling
│ ├── resources.py # Resource providers (README, tree, languages)
│ ├── prompts.py # Prompt templates (analyze, review, triage)
│ └── tools/
│ ├── __init__.py
│ ├── repos.py # Repository tools (search, get, file contents, commits)
│ ├── issues.py # Issue tools (list, get, create, comment)
│ ├── pulls.py # Pull request tools (list, get, diff)
│ └── users.py # User tools (profile, repos)
├── pyproject.toml
├── README.md
├── LICENSE
└── .gitignore🛠️ Технологический стек
Технология | Назначение |
Высокоуровневый фреймворк для MCP-серверов | |
Клиент GitHub REST API | |
Открытый стандарт интеграции ИИ-инструментов |
🤝 Вклад в разработку
Вклад приветствуется! Вот как это сделать:
Форкните репозиторий
Создайте ветку для новой функции (
git checkout -b feature/amazing-feature)Создайте коммит с изменениями (
git commit -m 'Add amazing feature')Отправьте ветку в репозиторий (
git push origin feature/amazing-feature)Откройте Pull Request
📄 Лицензия
Этот проект распространяется под лицензией MIT — подробности в файле LICENSE.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to analyze GitHub repositories, including fetching repository details, searching, and retrieving README content.4522ISC
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to perform GitHub operations such as creating repositories, issues, pull requests, and more through natural language.
- FlicenseBqualityDmaintenanceEnables AI assistants to inspect local Git repositories and interact with the GitHub API for reading commits, diffs, files, issues, comments, pull requests, and project boards.10121
- FlicenseCqualityBmaintenanceEnables AI assistants to interact with GitHub repositories via the REST API, supporting repository listing, detail retrieval, and issue management.2
Related MCP Connectors
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Screens public GitHub repos and PRs to generate risk maps, findings, and merge-readiness signals.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/pranjal-sen-2004/github-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server