MCP-Server (OnePieceServer & Geolocate)

This project contains two MCP servers developed with @modelcontextprotocol/sdk . Each exposes a useful tool that can be integrated with an MCP-compatible AI client.

📁 Content

• onePiece.ts: MCP server for querying One Piece characters

• geolocalizar.ts: MCP server for geolocating public IP addresses

Related MCP server: MyAnimeList MCP Server

⚙️ Requirements

• Node.js ≥ 18

• npm ≥ 9

📦 Install dependencies

npm install @modelcontextprotocol/sdk axios zod
npm install -D tsx

🏴‍☠️ OnePieceServer MCP

📄 Description

OnePieceServer allows you to view information about characters from the anime/manga One Piece, either individually or from the entire available list.

🚀 Run

npx tsx onePiece.ts

You can also use the MCP Inspector:

npx -y @modelcontextprotocol/inspector npx -y tsx onePiece.ts

🛠 Exposed tool: one_piece

• Input :

  { "id": "1" }

  For the complete list:

  { "id": "todos" }

• Output :

  {
    "content": [
      {
        "type": "text",
        "text": "Información del personaje: { ... }"
      }
    ]
  }

🌐 API used

• https://onepieceapi-50cm.onrender.com/personaje/{id}

• https://onepieceapi-50cm.onrender.com/personajes

🌍 Geolocate MCP

📄 Description

Geolocalizar allows you to obtain approximate geographic information from a public IP (IPv4) address.

🚀 Run

npx tsx main.ts

Or use with the MCP Inspector:

npx -y @modelcontextprotocol/inspector npx -y tsx main.ts

🛠 Exposed tool: geolocalizar

• Input :

  { "ip": "8.8.8.8" }

• Output :

  {
    "content": [
      {
        "type": "text",
        "text": "{ \"ip\": \"8.8.8.8\", \"country\": \"United States\", ... }"
      }
    ]
  }

🔐 Validation

Use zod to validate that the input is a valid IP in IPv4 format.

📁 Project Structure

.
├── geolocalizar.ts   # MCP Geolocalizar
├── onePiece.ts       # MCP OnePieceServer
├── package.json      # Archivo de configuracion de NPM
└── README.md         # Este archivo

🧪 Development

Both servers communicate via stdin and stdout using StdioServerTransport , allowing easy execution from CLI or integration with MCP clients.

🧑‍💻 Author

Developed by Diego Rodríguez
✉️ contacto@diegorodriguez.dev