MCP 服务器

MCP Servers (OnePiece & Geolocalizar)

A collection of two MCP servers that enable querying One Piece anime characters and geolocating public IP addresses.

Tools

one_piece

Herramienta para buscar informacion sobre personajes de One Piece

README

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

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.