Poke-MCP

개요

Poke-MCP는 표준화된 인터페이스를 통해 포켓몬 정보를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. PokeAPI 에 연결하여 포켓몬 데이터를 가���오고, Claude Desktop App, Continue, Cline 등 모든 MCP 호환 클라이언트에서 사용할 수 있는 MCP 도구를 통해 데이터를 제공합니다.

특징

• 이름으로 특정 포켓몬에 대한 정보를 얻으세요
• 무작위 포켓몬을 발견하세요
• 특정 지역(관동, 성도, 호연지방 등)의 무작위 포켓몬을 찾아보세요.
• 특정 타입(불, 물, 전기 등)의 포켓몬을 무작위로 획득하세요.
• 포켓몬 정보에 대한 자연어 쿼리 인터페이스

작동 원리

Poke-MCP는 AI 애플리케이션이 표준화된 방식으로 외부 도구 및 데이터 소스에 액세스할 수 있도록 하는 모델 컨텍스트 프로토콜(Model Context Protocol)을 사용하여 구축되었습니다. 서버는 다음과 같습니다.

1. 포켓몬 데이터를 가져오기 위해 PokeAPI에 연결합니다.
2. MCP 인터페이스를 통해 여러 도구를 노출합니다.
3. MCP 클라이언트의 요청을 처리합니다.
4. 포맷된 포켓몬 정보를 반환합니다.

MCP 도구

서버는 다음과 같은 도구를 제공합니다.

• get-pokemon: 이름으로 특정 포켓몬에 대한 자세한 정보를 얻습니다.
• random-pokemon: 무작위 포켓몬에 대한 정보를 얻으세요
• random-pokemon-from-region: 특정 지역의 무작위 포켓몬을 얻으세요
• random-pokemon-by-type: 특정 유형의 무작위 포켓몬을 얻으세요
• pokemon-query: 포켓몬에 대한 자연어 쿼리에 답변

건축학

서버는 다음을 사용하여 구축되었습니다.

• 타입스크립트
• MCP TypeScript SDK(@modelcontextprotocol/sdk)
• 입력 검증을 위한 Zod
• MCP 통신을 위한 표준 I/O 전송

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Pokémcp를 자동으로 설치하려면:

지엑스피1

수동 설치

용법

Claude 데스크톱 앱 사용

1. Claude Desktop App을 다운로드하고 설치하세요
2. Claude Desktop 설정 열기
3. 개발자 설정으로 이동하여 구성 파일을 편집하세요.
4. 다음 구성을 추가합니다.

5. Claude Desktop을 다시 시작하세요
6. 이제 Claude에서 사용 가능한 포켓몬 도구를 볼 수 있습니다.

예제 쿼리

MCP 클라이언트에 연결되면 다음과 같은 질문을 할 수 있습니다.

• "피카츄에 대해 말해줘"
• "무작위로 포켓몬을 하나 주세요"
• "칸토 지방의 포켓몬을 무작위로 보여주세요"
• "무작위로 등장하는 물 포켓몬은 뭐예요?"

프로젝트 구조

• src/index.ts: 메인 서버 구현
• src/types.ts: 포켓몬 데이터에 대한 TypeScript 유형 정의
• package.json: 프로젝트 종속성 및 스크립트
• tsconfig.json: TypeScript 구성

새로운 기능 추가

새로운 도구를 추가하거나 기존 도구를 개선하려면:

1. 데이터를 가져오고 포맷하기 위한 새로운 도우미 함수 정의
2. server.tool() 메서드를 사용하여 새 도구를 등록합니다.
3. 요청을 처리하고 응답을 반환하기 위한 도구 논리를 구현합니다.

특허

아이에스씨

감사의 말

• 포켓몬 데이터를 제공하는 PokeAPI
• 표준화된 인터페이스를 위한 모델 컨텍스트 프로토콜

이 프로젝트는 AI 어시스턴트에 도메인별 지식과 기능을 확장할 수 있는 맞춤형 MCP 서버를 구축하는 방법을 보여줍니다.