github-projects-mcp

Проекты GitHub V2 MCP-сервер

Сервер Model Context Protocol (MCP), который предоставляет инструменты для управления GitHub Projects V2 через Claude и другие клиенты MCP. Этот сервер использует API GitHub GraphQL для взаимодействия с GitHub Projects V2.

Функции

• Список и просмотр проектов GitHub V2 для пользователей и организаций
• Получить поля и элементы проекта (проблемы, PR, черновики проблем)
• Создавайте проблемы и добавляйте их в проекты
• Создавайте черновики выпусков непосредственно в проектах
• Обновить значения полей элемента проекта
• Удалить элементы из проектов

Использование

Этот сервер можно использовать с любым клиентом MCP, например Claude Desktop. Добавьте его в конфигурацию вашего клиента MCP (например, claude_desktop_config.json ).

Вариант 1: Использование опубликованного пакета

Вот пример конфигурации с использованием uvx в качестве средства запуска команд:

Обязательно замените your_pat_here на ваш фактический токен личного доступа GitHub.

Вариант 2: Из исходного кода

Чтобы запустить проект непосредственно из исходного кода, выполните следующие действия:

Настраивать

1. Клонируйте репозиторий:
   git clone git@github.com:Arclio/github-projects-mcp.git cd github-projects-mcp
2. Создайте и активируйте виртуальную среду:
   uv venv source venv/bin/activate
3. Установите зависимости:
   uv pip install -e .
4. Установите свой токен GitHub как переменную среды:Создайте токен личного доступа GitHub и дайте ему необходимые разрешения. Требуемые разрешения: repo , project и read:org .Добавьте токен в файл .env после выполнения этой команды:
   cp .env.example .env
   Затем добавьте в ваш файл .env следующее:
   export GITHUB_TOKEN=your_personal_access_token

Использование из исходного кода

При использовании исходного кода настройте клиент MCP следующим образом:

Обязательно замените /path/to/github-projects-mcp и your_pat_here на фактический путь к вашему репозиторию и токен личного доступа GitHub.

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

• list_projects : Список проектов GitHub V2 для указанной организации или пользователя
• get_project_fields : Получить поля, доступные в проекте GitHub V2
• get_project_items : получение элементов в проекте GitHub V2 (поддерживает фильтрацию по состоянию или пользовательским полям с одиночным выбором)
• create_issue : Создать новую проблему на GitHub
• add_issue_to_project : Добавить существующую задачу GitHub в проект V2
• update_project_item_field : обновить значение поля для элемента проекта
• create_draft_issue : создание черновика проблемы непосредственно в проекте GitHub V2
• delete_project_item : Удалить элемент из проекта GitHub V2

Подробную информацию об использовании смотрите в документации по инструменту в коде сервера.

Разработка

Проект структурирован следующим образом:

• src/github_projects_mcp/ : Основной каталог пакета
  • server.py : реализация сервера MCP с определениями инструментов
  • github_client.py : клиент GraphQL для взаимодействия с API GitHub

Чтобы внести свой вклад, обязательно:

1. Добавить правильную обработку ошибок для всех операций GraphQL.
2. Добавить аннотации типов для всех функций и параметров
3. Обновляйте документацию при добавлении новых инструментов или функций.