MCP-Server(OnePieceServer 및 Geolocate)

이 프로젝트에는 @modelcontextprotocol/sdk 로 개발된 두 개의 MCP 서버가 포함되어 있습니다. 각각은 MCP 호환 AI 클라이언트에 통합될 수 있는 유용한 도구를 제공합니다.

📁 콘텐츠

• onePiece.ts: 원피스 캐릭터 쿼리를 위한 MCP 서버

• geolocalizar.ts: 공용 IP 주소를 지리적으로 찾기 위한 MCP 서버

Related MCP server: MyAnimeList MCP Server

⚙️ 요구 사항

• 노드.js ≥ 18

• npm ≥ 9

📦 종속성 설치

지엑스피1

🏴‍☠️ 원피스서버 MCP

📄 설명

OnePieceServer 이용하면 애니메이션/만화 원피스의 캐릭터에 대한 정보를 개별적으로 또는 사용 가능한 전체 목록에서 볼 수 있습니다.

🚀 달리다

npx tsx onePiece.ts

MCP 검사기를 사용할 수도 있습니다.

npx -y @modelcontextprotocol/inspector npx -y tsx onePiece.ts

🛠 노출된 도구: one_piece

• 입력 :

  { "id": "1" }

  전체 목록은 다음과 같습니다.

  { "id": "todos" }

• 출력 :

  {
    "content": [
      {
        "type": "text",
        "text": "Información del personaje: { ... }"
      }
    ]
  }

🌐 사용된 API

• https://onepieceapi-50cm.onrender.com/personaje/{id}

• https://onepieceapi-50cm.onrender.com/personajes

🌍 MCP 지리적 위치 확인

📄 설명

Geolocalizar 이용하면 공용 IP(IPv4) 주소에서 대략적인 지리적 정보를 얻을 수 있습니다.

🚀 달리다

npx tsx main.ts

또는 MCP Inspector와 함께 사용하세요.

npx -y @modelcontextprotocol/inspector npx -y tsx main.ts

🛠 노출된 도구: geolocalizar

• 입력 :

  { "ip": "8.8.8.8" }

• 출력 :

  {
    "content": [
      {
        "type": "text",
        "text": "{ \"ip\": \"8.8.8.8\", \"country\": \"United States\", ... }"
      }
    ]
  }

🔐 검증

zod 사용하여 입력이 IPv4 형식의 유효한 IP인지 확인합니다.

📁 프로젝트 구조

.
├── geolocalizar.ts   # MCP Geolocalizar
├── onePiece.ts       # MCP OnePieceServer
├── package.json      # Archivo de configuracion de NPM
└── README.md         # Este archivo

🧪 개발

두 서버는 StdioServerTransport 사용하여 stdin 및 stdout 으로 통신하므로 CLI에서 쉽게 실행하거나 MCP 클라이언트와 통합할 수 있습니다.

🧑‍💻 저자

Diego Rodríguez 가 개발
✉️ contacto@diegorodriguez.dev