Skip to main content
Glama
pranjal-sen-2004

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

Описание

search_repositories

Поиск репозиториев GitHub по запросу, языку, звёздам

get_repository

Получение подробной информации о репозитории (звёзды, форки, темы и т. д.)

get_file_contents

Чтение любого файла из репозитория

list_commits

Список последних коммитов с фильтрами

list_issues

Список issues с фильтрами по статусу, метке, исполнителю

get_issue

Полное содержимое issue + комментарии

create_issue

Создание нового issue

add_issue_comment

Добавление комментария к issue

list_pull_requests

Список PR с фильтрами по статусу/ветке

get_pull_request

Информация о PR + статус слияния

get_pull_request_diff

Просмотр изменений кода в PR

get_user_profile

Публичный профиль пользователя

list_user_repos

Список репозиториев пользователя

📦 Ресурсы (управляются приложением)

Контекстные данные, которые ИИ может читать:

URI ресурса

Описание

github://repo/{owner}/{repo}/readme

README репозитория (Markdown)

github://repo/{owner}/{repo}/tree

Полное дерево файлов

github://repo/{owner}/{repo}/languages

Распределение по языкам в процентах

💬 Промпты (запускаются пользователем)

Готовые шаблоны рабочих процессов:

Промпт

Описание

analyze-repo

Комплексный анализ репозитория

review-pr

Ревью кода с учётом лучших практик

issue-triage

Категоризация и приоритизация открытых 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

🛠️ Технологический стек

Технология

Назначение

FastMCP

Высокоуровневый фреймворк для MCP-серверов

PyGithub

Клиент GitHub REST API

Model Context Protocol

Открытый стандарт интеграции ИИ-инструментов


🤝 Вклад в разработку

Вклад приветствуется! Вот как это сделать:

  1. Форкните репозиторий

  2. Создайте ветку для новой функции (git checkout -b feature/amazing-feature)

  3. Создайте коммит с изменениями (git commit -m 'Add amazing feature')

  4. Отправьте ветку в репозиторий (git push origin feature/amazing-feature)

  5. Откройте Pull Request


📄 Лицензия

Этот проект распространяется под лицензией MIT — подробности в файле LICENSE.


Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

View all related MCP servers

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.

View all MCP Connectors

Latest Blog Posts

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