Pokémon TCG API — MCP-сервер для Claude Code: обзор и запуск
Подключает каталог коллекционных карт Pokémon к вашему ИИ-ассистенту: поиск по сетам, авторы, рыночные цены и проверка центровки по фото.
claude mcp add --env PTCG_API_KEY=<PTCG_API_KEY> --env PTCG_BASE_URL=<PTCG_BASE_URL> --transport stdio pokemon-tcg-api -- npx -y @pokemontcgapi/mcpЧто делает Pokémon TCG API
Сервер даёт агенту одиннадцать специализированных инструментов для работы с базой pokemontcgapi.com. Модель может запрашивать данные по международным, японским или китайским выпускам, сверять цены с учётом грейда и объёма выборки, фильтровать карты по редкости и художникам. Никаких правок в базу инструменты не вносят: каждый вызов помечен как безопасный для чтения.
Для десяти из одиннадцати функций обязательно нужен ключ PTCG_API_KEY, иначе запросы вернут ошибку авторизации. Единственное полностью публичное действие — получение справочника типов и редкостей. Распознавание карточек по фотографии и расчёт центровки расходуют платные кредиты аккаунта, поэтому агент не должен перезапускать их вслепую.
Для работы локального процесса требуется среда Node.js версии не ниже 20.
Какие задачи решает
- найти цены на конкретную карту с учётом грейда и тиража
- проверить геометрические пропорции и центровку карты по фотографии
- получить список японских или китайских сетов за выбранный период
- выгрузить перечень карт определённого иллюстратора
Примеры запросов агенту
- Найди все карты Чаризарда из японских сетов и покажи свежие цены
- Оцени центровку карты по прикреплённой фотографии лицевой стороны
- Покажи список сетов, вышедших в 2024 году, и карты художника Ken Sugimori
Как установить Pokémon TCG API
Командой платформы
claude mcp add --env PTCG_API_KEY=<PTCG_API_KEY> --env PTCG_BASE_URL=<PTCG_BASE_URL> --transport stdio pokemon-tcg-api -- npx -y @pokemontcgapi/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add pokemon-tcg-api --env PTCG_API_KEY=<PTCG_API_KEY> --env PTCG_BASE_URL=<PTCG_BASE_URL> -- npx -y @pokemontcgapi/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"pokemon-tcg-api": {
"command": "npx",
"args": [
"-y",
"@pokemontcgapi/mcp"
],
"env": {
"PTCG_API_KEY": "<PTCG_API_KEY>",
"PTCG_BASE_URL": "<PTCG_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"pokemon-tcg-api": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pokemontcgapi/mcp"
],
"env": {
"PTCG_API_KEY": "<PTCG_API_KEY>",
"PTCG_BASE_URL": "<PTCG_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PTCG_API_KEY=<PTCG_API_KEY> -e PTCG_BASE_URL=<PTCG_BASE_URL> pokemon-tcg-api npx -y @pokemontcgapi/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Pokémon TCG API
Как установить Pokémon TCG API в Claude Code?
Выполните команду claude mcp add mcp -e PTCG_API_KEY=<PTCG_API_KEY> -- npx -y @pokemontcgapi/mcp в терминале, подставив собственный ключ.
Что делает этот MCP-сервер?
Он предоставляет ИИ-ассистенту доступ к глобальной базе карт Pokémon TCG, позволяя искать релизы, авторов, цены и анализировать фото карт.
Можно ли пользоваться инструментами без API-ключа?
Без ключа сервер запустится, но выполнить получится только чтение справочника допустимых типов и редкостей.
