Skip to main content
Glama
deenesjakoruzh
grovesjosephn

Pokemon MCP Server

by grovesjosephn
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

포켓몬 MCP 서버

표준화된 도구를 통해 포켓몬 데이터를 제공하는 모델 컨텍스트 프로토콜(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

  1. 의존성 설치:

bun install

  1. 데이터베이스 설정:

./scripts/setup.sh

  1. 모든 패키지 빌드:

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. 풀 리퀘스트 제출

커밋 가이드라인

컨벤셔널 커밋(Conventional Commit) 형식을 사용하세요:

<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 파일을 참조하세요

링크

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
F
license - not found
Not graded
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • PokeMCP

    ChiragAgg5k
    F
    license
    B
    quality
    D
    maintenance
    An MCP server that provides detailed Pokémon information by integrating with the PokeAPI, allowing users to fetch comprehensive data about Pokémon and simulate battles.
    2
    2

  • PokéAPI MCP Server

    kumaranvpl
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP (Multi-Agent Conversation Protocol) Server that provides an interface to access Pokémon data through the PokéAPI, enabling agents to retrieve information about Pokémon species, abilities, moves, and more via natural language.

  • Poke-MCP

    Jalajil
    F
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides comprehensive Pokemon data and battle simulation capabilities to AI assistants. It enables users to access detailed stats, types, and moves while simulating battles with realistic mechanics like type effectiveness and status effects.

View all related MCP servers

Related MCP Connectors

  • mcp

    GibsonAI MCP server: manage your databases with natural language

  • driflyte-mcp-server

    Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.

  • Danushkumar-V-mcp-discord

    An MCP server that integrates with Discord to provide AI-powered features.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/grovesjosephn/pokemcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server