Плагин для Claude Code и Codex: модели Pydantic v2, протоколы PEP 544 и MCP-сервер для управления досками GitHub Projects v2 (например, github.com/users/<owner>/projects/<n>) — с полноценной поддержкой чернового метода HTTP QUERY.
server.py MCP server (mcp SDK v2, stdio) — 19 tools, structured output
│ depends on
protocols.py ProjectsBackend / GraphQLTransport (runtime-checkable Protocols)
│ implemented by
service.py GitHubProjectsService — GraphQL over the transport,
project-id + field caching, string→typed field-value coercion
graphql.py GraphQL documents (works for both user and org owners)
http.py QueryClient — HTTP QUERY (draft-ietf-httpbis-safe-method-w-body)
with per-origin capability memory and POST fallback
models.py Frozen Pydantic v2 models, __typename-discriminated unionsСлой MCP зависит только от протокола ProjectsBackend, поэтому бэкенды взаимозаменяемы, а тесты структурно подставляют фейки.
QueryClient отправляет QUERY оптимистично, фиксирует анонсы Accept-Query, повторяет попытку один раз при транспортных ошибках (QUERY безопасен и идемпотентен) и навсегда переключается на POST для каждого origin при 405/501 — так что он работает с GitHub уже сегодня и сам переключается на QUERY, когда GitHub добавит его поддержку.
Related MCP server: GitHub Project MCP Server
Основная среда выполнения — CPython 3.14.7 free-threaded (3.14.7t). Также требуется, чтобы CLI gh был аутентифицирован с областью project:
gh auth refresh -s project # grants read + write for Projects v2Токены извлекаются из GITHUB_TOKEN / GH_TOKEN, иначе используется gh auth token.
uv sync
uv run pytest # 32 tests
uv run gh-projects-mcp # run the server on stdioИз корня репозитория:
# Claude Code (registered user-wide)
claude mcp add --scope user github-projects -- uv --directory "$PWD" run gh-projects-mcp
# Codex
codex mcp add github-projects -- uv --directory "$PWD" run gh-projects-mcpМанифесты плагинов находятся в .claude-plugin/plugin.json (MCP-сервер объявлен через ${CLAUDE_PLUGIN_ROOT}) и .codex-plugin/plugin.json; навык использования для обоих хостов — в skills/github-projects/SKILL.md.
Инструмент | Назначение |
| Список досок для пользователя/организации (необязательный поиск) |
| Доска по владельцу + номеру |
| Поля, включая варианты одиночного выбора и итерации |
| Элементы с содержимым и значениями полей, при необходимости вычисленные по фильтрующему запросу сохранённого представления |
| Создать доску; изменить название/readme/видимость/закрыто |
| Добавить issue/PR по URL |
| Добавить черновик issue |
| Установить поле; значения — строки, приводимые к типу поля — одиночный выбор и итерации сопоставляются по имени ( |
| Очистить поле |
| Архивировать или удалить элемент |
| Идемпотентное приведение к желаемому состоянию: поля и псевдонимы вариантов, семантически проверенные листовые/контейнерные представления, упорядоченные колонки, явные выводы из эксплуатации, метаданные элементов, иерархия эпик/под-issue, нативные зависимости issue и очистка устаревших текстовых описаний зависимостей |
| Представление статусной колонки для одной итерации (или всех элементов + незапланированного бакета) |
| Сводка завершённости по эпикам из нативной иерархии под-issue |
| Сохранённые представления с названием, макетом, фильтром и упорядоченными видимыми полями |
| Долгосрочная контекстная история проекта |
This server cannot be deployed
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
