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

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

Функции

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

Related MCP server: GitHub MCP Server Plus

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

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

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

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

{ "mcpServers": { "github-projects": { "command": "uvx", "args": [ "mcp-github-projects" ], "env": { "GITHUB_TOKEN": "your_pat_here" } } } }

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

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

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

Настраивать

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

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

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

{ "mcpServers": { "github-projects": { "command": "uv", "args": [ "--directory", "/path/to/github-projects-mcp", "run", "mcp-github-projects" ], "env": { "GITHUB_TOKEN": "your_pat_here" } } } }

Обязательно замените /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

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