What is Mcp Servers

MCP-Servers is a project that contains two MCP servers developed using the @modelcontextprotocol/sdk. These servers provide useful tools that can be integrated by AI clients compatible with MCP.

Use cases

Use cases include retrieving character details from One Piece for fans and applications, as well as obtaining geographical information based on public IP addresses for analytics or location-based services.

How to use

To use MCP-Servers, install the required dependencies with npm, and run the servers using the command ‘npx tsx onePiece.ts’ for the OnePieceServer or ‘npx tsx main.ts’ for the Geolocalizar server.

Key features

Key features include the ability to query information about One Piece characters and geolocate public IP addresses. Each server exposes a specific tool for these functionalities.

Where to use

MCP-Servers can be used in various fields such as entertainment (for anime/manga information) and networking (for IP geolocation services).

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.

---

🧑‍💻 Autor

Desarrollado por Diego Rodríguez
✉️ [email protected]

---

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