Pokemon MCP Server

Сервер протокола контекста модели (MCP), предоставляющий данные о покемонах через стандартизированные инструменты. Этот монорепозиторий содержит как MCP-сервер, так и службу сбора данных для получения информации о покемонах из PokeAPI.

Архитектура

Это PNPM-монорепозиторий с двумя основными пакетами:

• pokemon-mcp-server: MCP-сервер, который предоставляет данные о покемонах через стандартизированные инструменты

• pokemon-mcp-ingestion: Служба сбора данных, которая получает информацию из PokeAPI и сохраняет её в SQLite

Система использует общую базу данных SQLite (data/pokemon.sqlite) для хранения данных о покемонах.

Related MCP server: PokeMCP

Возможности

Доступные инструменты MCP

• get_pokemon — Получение подробной информации о конкретном покемоне

• search_pokemon — Поиск покемонов по имени, типу или другим критериям

• get_strongest_pokemon — Поиск сильнейших покемонов по различным характеристикам

• get_pokemon_stats — Получение подробных характеристик покемона

• compare_pokemon — Сравнение характеристик двух покемонов

• get_type_effectiveness — Получение информации об эффективности типов

Охват данных

• Полные данные о покемонах из PokeAPI

• Характеристики, типы, способности и многое другое

• Взаимосвязи эффективности типов

• Поиск по нескольким критериям

Быстрый старт

Предварительные требования

• Node.js 18+

• PNPM

• Git

Установка

1. Клонируйте репозиторий:

git clone https://github.com/grovesjosephn/pokemcp.git
cd pokemcp

2. Установите зависимости:

bun install

3. Настройте базу данных:

./scripts/setup.sh

4. Соберите все пакеты:

bun run build

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

Запуск MCP-сервера

# Development mode (with hot reload)
bun run dev

# Production mode
cd packages/pokemon-mcp-server
bun run start

Тестирование с помощью MCP Inspector

# Visual GUI testing
cd packages/pokemon-mcp-server
bun run inspect

# CLI testing
bun run inspect:cli

Сбор данных

# Run data ingestion
cd packages/pokemon-mcp-ingestion
bun run start

Интеграция с Claude Desktop

Вариант 1: NPM-пакет (рекомендуется)

Установите сервер глобально:

cd packages/pokemon-mcp-server
bun run build
npm link

Настройте Claude Desktop:

{
  "mcpServers": {
    "pokemon": {
      "command": "pokemon-mcp-server",
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

Вариант 2: Прямое выполнение через Node

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["/path/to/pokemcp/packages/pokemon-mcp-server/dist/server.js"],
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

Вариант 3: Режим разработки

{
  "mcpServers": {
    "pokemon": {
      "command": "bun",
      "args": ["/path/to/pokemcp/packages/pokemon-mcp-server/server.ts"],
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

Разработка

Команды рабочего пространства

bun run build         # Build all packages
bun run dev           # Run all packages in development mode
bun run test          # Run tests for all packages
bun run format        # Format all files
bun run format:check  # Check formatting

Команды пакета сервера

cd packages/pokemon-mcp-server

bun run build         # Compile TypeScript
bun run dev           # Watch mode
bun run start         # Run server
bun run inspect       # Run MCP Inspector GUI
bun run inspect:cli   # Run MCP Inspector CLI
bun test              # Run tests

Команды пакета сбора данных

cd packages/pokemon-mcp-ingestion

bun run build         # Compile TypeScript
bun run dev           # Watch mode
bun run start         # Run ingestion
bun test              # Run tests

Тестирование

Проект использует встроенный инструмент тестирования bun:

# Run all tests
bun run test

# Run specific package tests
cd packages/pokemon-mcp-server && bun test
cd packages/pokemon-mcp-ingestion && bun test

Схема базы данных

База данных SQLite включает таблицы для:

• pokemon — Базовая информация о покемонах

• stats — Характеристики покемонов (HP, атака, защита и т. д.)

• types — Типы покемонов и их взаимосвязи

• abilities — Способности покемонов

Внесение вклада

1. Сделайте форк репозитория

2. Создайте ветку для функции

3. Внесите свои изменения

4. Добавьте тесты

5. Выполните bun run format

6. Отправьте pull request

Рекомендации по коммитам

Используйте формат обычных коммитов:

<type>[optional scope]: <description>

Examples:
- feat(server): add Pokemon evolution chain tool
- fix(ingestion): handle missing species URL gracefully
- docs: update integration guide

Лицензия

Лицензия MIT — подробности см. в файле LICENSE

Ссылки

• Model Context Protocol

• PokeAPI

• Claude Desktop