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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Servers (OnePiece & Geolocalizar)find Luffy's character details"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
npm install @modelcontextprotocol/sdk axios zod
npm install -D tsx🏴☠️ 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
npx tsx onePiece.tsTambién puedes usar el Inspector MCP:
npx -y @modelcontextprotocol/inspector npx -y tsx onePiece.ts🛠 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
npx tsx main.tsO usar con el Inspector MCP:
npx -y @modelcontextprotocol/inspector npx -y tsx main.ts🛠 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
.
├── geolocalizar.ts # MCP Geolocalizar
├── onePiece.ts # MCP OnePieceServer
├── package.json # Archivo de configuracion de NPM
└── README.md # Este archivo🧪 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:
npx -y @smithery/cli install @Haonter/MCP-Servers --client claude