MCP Servers (OnePiece & Geolocalizar)

MCP-Server (OnePieceServer & Geolocalizar)

Este proyecto contiene dos servidores MCP desarrollados con @modelcontextprotocol/sdk. Cada uno expone una herramienta útil que puede ser integrada por un cliente AI compatible con MCP.

📁 Contenido

• onePiece.ts: Servidor MCP para consultar personajes de One Piece
• geolocalizar.ts: Servidor MCP para geolocalizar direcciones IP públicas

⚙️ Requisitos

• Node.js ≥ 18
• npm ≥ 9

📦 Instalar dependencias

🏴‍☠️ OnePieceServer MCP

📄 Descripción

OnePieceServer permite consultar información de personajes del anime/manga One Piece, ya sea individualmente o toda la lista disponible.

🚀 Ejecutar

También puedes usar el Inspector MCP:

🛠 Herramienta expuesta: one_piece

• Input:
  { "id": "1" }
  Para obtener la lista completa:
  { "id": "todos" }
• Output:
  { "content": [ { "type": "text", "text": "Información del personaje: { ... }" } ] }

🌐 API usada

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

🌍 Geolocalizar MCP

📄 Descripción

Geolocalizar permite obtener información geográfica aproximada de una dirección IP (IPv4) pública.

🚀 Ejecutar

O usar con el Inspector MCP:

🛠 Herramienta expuesta: geolocalizar

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

🔐 Validación

Usa zod para validar que el input sea una IP válida en formato IPv4.

📁 Estructura del Proyecto

🧪 Desarrollo

Ambos servidores se comunican mediante stdin y stdout usando StdioServerTransport, lo que permite su ejecución fácil desde CLI o integración con clientes MCP.

🧑‍💻 Autor

Desarrollado por Diego Rodríguez
✉️ contacto@diegorodriguez.dev

Installing via Smithery

To install OnePiece & Geolocalizar MCP Servers for Claude Desktop automatically via Smithery: