MCP-Server (OnePieceServer & Geolocalizar)
About
A project containing two MCP servers built with the Model Context Protocol SDK: OnePieceServer queries character information from the One Piece anime/manga API, and Geolocalizar retrieves approximate geographic data for a public IPv4 address. It is intended for AI clients that…
Details
- Author
- MCP-Mirror
- Downloads
- 229
- Categories
- Other
Jump to
- One Piece character query tool (one_piece)
- Geolocation tool for public IPv4 (geolocalizar)
- Uses StdioServerTransport for CLI/AI integration
- Input validation with zod for IP addresses
- Retrieve single character or full list of characters
- Approximate geographic data from IP (country, etc.)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP-Server (OnePieceServer & Geolocalizar)Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Node.js ≥18 and npm ≥9, then run npm install @modelcontextprotocol/sdk axios zod to install dependencies. Execute each server individually with npx tsx onePiece.ts for OnePieceServer or npx tsx main.ts for Geolocalizar. The servers communicate via stdin/stdout using StdioServerTransport.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-server (onepieceserver & geolocalizar)": {
"Haonter_MCP-Servers": {
"command": "npx",
"args": [
"tsx",
"onePiece.ts"
]
}
}
}
}McpServers
{
"Haonter_MCP-Servers": {
"command": "npx",
"args": [
"tsx",
"onePiece.ts"
]
}
}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.
<a href="https://glama.ai/mcp/servers/@Haonter/MCP-Servers">
</a>
---
📁 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
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.ts
Tambié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.ts
O 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
