GitHubCard
GitHubCard — MCP-сервер сообщества (автор — ghcardhq). Карточки профилей и репозиториев GitHub для README, превью ссылок и соцсетей. Подключается как удалённый сервер. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- ghcardhq
- Лицензия
- MIT
- Транспорт
- stdio, streamable_http
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- Не указаны
Уровень риска: high
Создаёт и удаляет карточки в аккаунте GitHubCard; локально может править README при флаге --allow-file-writes.
Настройка клиентов
{
"code": "[mcp_servers.githubcard]\nurl = \"https://githubcard.com/mcp\"\nbearer_token_env_var = \"GHCARD_API_KEY\"",
"file": "~/.codex/config.toml",
"lang": "toml",
"verified": "docs"
}
Что умеет
GitHubCard MCP — официальный сервер сервиса GitHubCard, который позволяет ИИ-ассистенту создавать картинки-карточки профилей и репозиториев GitHub для README, превью ссылок и постов в соцсетях. Карточки показывают живые данные GitHub: изображение всегда отражает текущее состояние, пересоздавать его не нужно.
Есть два варианта: размещённый сервер https://githubcard.com/mcp (Streamable HTTP, ничего не устанавливается) и локальный — npx -y @ghcardhq/ghcard mcp из CLI ghcard, который умеет ещё и править README на диске.
Инструменты:
create_card— создаёт (или берёт существующую) карточку для пользователя, репозиторияowner/repoили ссылки GitHub; возвращает ссылки на SVG и PNG и готовые фрагменты Markdown и HTML. Операция идемпотентна: одинаковые входные данные дают ту же карточку и ссылку. Расходует одну единицу дневной квоты.validate_card— пробный запускcreate_card: проверяет идентификаторы, функции Pro и свои дизайны, квоту не тратит.list_templates,list_palettes,list_components— макеты (с фильтром по профилю или репозиторию и по бесплатному тарифу), фоновые палитры и типы виджетов.get_template_designиget_card_design— макет шаблона или вашей карточки как редактируемый документ дизайна.list_cards,delete_card,get_usage— ваши карточки, удаление (ссылки перестают работать), тариф и остаток квоты на сегодня.update_readme— вставляет или обновляет карточку в Markdown-файле; только в локальном режиме с флагом--allow-file-writes.
Ошибки возвращаются с устойчивым кодом, признаком, можно ли повторить, и подсказкой модели, что делать дальше.
Кому подойдёт
Авторам open source и разработчикам, которые оформляют README, превью репозиториев и посты о проектах. Похожие серверы — в категории дизайн.
Установка
Для создания карточек нужен бесплатный ключ API: войдите на githubcard.com/dashboard и создайте его в разделе API keys (вида ghc_live_…). Без ключа сервер всё равно показывает шаблоны, палитры, виджеты и макеты. Для локального режима нужен Node.js 20 или новее, ключ передаётся в GHCARD_API_KEY.
Подключение к клиентам
Конфигурации из README. Подробнее — в инструкции как подключить MCP.
claude mcp add --transport http githubcard https://githubcard.com/mcp \
--header "Authorization: Bearer ghc_live_…"Claude Desktop пока не умеет передавать свои заголовки коннекторам, поэтому ключ передаётся через локальный сервер в claude_desktop_config.json. Для Cursor — ~/.cursor/mcp.json, для Codex — ~/.codex/config.toml и экспорт GHCARD_API_KEY в оболочке. В README есть также конфиги для VS Code (ключ запрашивается один раз и хранится безопасно) и Windsurf, расширение для Gemini CLI и плагин для Claude Code.
Проверка
Попросите агента вызвать get_usage — он покажет тариф и остаток дневной квоты.
Примеры задач
Сделай карточку GitHubCard для моего профиля и добавь её в начало README.Создай тёмную карточку для vercel/next.js для превью ссылки, компактный шаблон без виджета языка.Риски
- Удаление карточек. После
delete_cardссылки перестают работать — в том числе в уже опубликованных README. - Запись в файлы возможна только в локальном режиме с
--allow-file-writes. - Ключ API храните в переменной окружения или в защищённом хранилище клиента.
- Лимиты. Бесплатно — 100 карточек в день, на Pro — 5000; квота сбрасывается в 00:00 UTC, неудачные вызовы не считаются. На бесплатных карточках есть небольшой водяной знак.
Частые вопросы
Нужно ли пересоздавать карточку при новых звёздах?
Нет, изображение всегда показывает текущие данные GitHub.
Можно ли попробовать без ключа?
Да, шаблоны, палитры и макеты доступны без ключа; создание карточек требует ключ.
Может ли агент сам вставить карточку в README?
Да, через update_readme в локальном режиме с флагом --allow-file-writes.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.