Проекты 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. Обновляйте документацию при добавлении новых инструментов или функций.