포켓MCP

PokeMCP는 PokeAPI 와 연동하여 상세한 포켓몬 정보를 제공하는 MCP(Modular Command Platform) 서버입니다. 포켓몬의 기본 능력치, 타입, 능력(효과 포함), 기술(효과 포함), 진화 체인 등 모든 포켓몬에 대한 포괄적인 데이터를 가져오는 도구를 제공합니다.

특징

• 포켓몬 기본 통계, 유형 및 능력(효과 설명 포함)을 가져옵니다.

• 포켓몬당 최대 10개의 기술을 검색합니다. 여기에는 기술 효과도 포함됩니다.

• 주어진 포켓몬에 대한 전체 진화 체인을 제공합니다.

• 오류를 우아하게 처리하고 유익한 오류 메시지를 반환합니다.

Related MCP server: Poke-MCP

요구 사항

• 파이썬 3.11.4+

• httpx (비동기 HTTP 요청용)

• mcp.server.fastmcp (MCP 서버 프레임워크용)

설치

1. 이 저장소를 복제하세요:

   지엑스피1

2. uv를 사용하여 종속성을 설치합니다:

   uv sync

용법

개발 서버

uv를 사용하여 서버를 실행합니다(필요한 MCP 인프라가 있는지 확인하세요):

uv run mcp dev server.py

클로드와 연결

Claude에 연결하려면 다음 명령을 실행하세요.

uv run mcp install server.py

결과는 다음과 같습니다.

Added server 'poke-mcp' to Claude config   
Successfully installed poke-mcp in Claude app 

이제 Claude에서 poke-mcp MCP 도구를 사용할 수 있습니다.

포켓몬 정보 얻기

전투 시뮬레이션

여기에서 Cursor와 같은 다른 MCP 클라이언트에 서버를 연결하는 방법을 알아보세요.

API

도구: get_pokemon_info

포켓몬에 대한 자세한 정보를 가져옵니다.

인수

• pokemon_name (str): 포켓몬의 이름(대소문자 구분 없음)

보고

다음과 같은 구조를 가진 사전:

{
  "name": "pikachu",
  "id": 25,
  "base_stats": {
    "hp": 35,
    "attack": 55,
    ...
  },
  "types": ["electric"],
  "abilities": [
    {"name": "static", "effect": "May paralyze on contact."},
    ...
  ],
  "moves": [
    {"name": "thunder-shock", "effect": "Has a 10% chance to paralyze the target."},
    ...
  ],
  "evolution_chain": ["pichu", "pikachu", "raichu"]
}

오류 처리

포켓몬을 찾을 수 없거나 네트워크 오류가 발생한 경우, 응답에는 설명 메시지와 함께 error 키가 포함됩니다.

도구: simulate_battle

핵심 역학(통계, 유형, 상태 효과)을 사용하여 두 포켓몬 간의 포켓몬 전투를 시뮬레이션합니다.

인수

• pokemon1 (str): 첫 번째 포켓몬의 이름(대소문자 구분 없음)

• pokemon2 (str): 두 번째 포켓몬의 이름(대소문자 구분 없음)

보고

다음과 같은 구조를 가진 사전:

{
  "pokemon1": "pikachu",
  "pokemon2": "charizard",
  "initial_hp": {
    "pikachu": 35,
    "charizard": 78
  },
  "battle_log": [
    "Turn 1:",
    "charizard uses mega-punch and deals 75 damage! (pikachu HP: 0)",
    "pikachu fainted!",
    "Winner: charizard!"
  ],
  "winner": "charizard"
}

오류 처리

포켓몬을 찾을 수 없거나 네트워크 오류가 발생한 경우, 응답에는 설명 메시지와 함께 error 키가 포함됩니다.

특허

이 프로젝트는 PokeAPI를 사용하며 교육 및 비상업적 용도로 사용됩니다.