The MCP Servers (OnePiece & Geolocalizar) provide two distinct functionalities:
OnePieceServer: Query One Piece character information by ID or retrieve a complete list of characters
Geolocalizar: Geolocate public IPv4 addresses to obtain country and location information
Both servers were developed with ModelContextProtocol SDK and can be executed via CLI or MCP Inspector.
Used to make HTTP requests to external APIs, enabling the MCP server to fetch One Piece character data and geolocation information for IP addresses.
Required runtime environment for the MCP server, with version 18 or higher needed.
Package manager used for installing dependencies, with version 9 or higher required.
The MCP server connects to a One Piece API hosted on Render (onepieceapi-50cm.onrender.com) to retrieve character information.
Provides validation for the geolocalizar tool to ensure inputs are valid IPv4 addresses.
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
Related MCP server: MCP Pokemon Server
⚙️ 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: