MCP Servers

🚀 MCP-Server (OnePieceServer & Geolocalizar)

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

🚀 Quick Start

✨ Features

This project includes two MCP servers with the following features:

• OnePieceServer: Allows querying information about One Piece characters.
• Geolocalizar: Enables obtaining approximate geographical information of public IP addresses.

📦 Installation

Requirements

• Node.js ≥ 18
• npm ≥ 9

Install Dependencies

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

💻 Usage Examples

🏴‍☠️ OnePieceServer MCP

Description

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

Run the Server

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" }
  

  To get the full list:

  { "id": "todos" }
  

• Output:

  {
    "content": [
      {
        "type": "text",
        "text": "Character information: { ... }"
      }
    ]
  }
  

APIs Used

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

🌍 Geolocalizar MCP

Description

Geolocalizar allows obtaining approximate geographical information of a public IP address (IPv4).

Run the Server

npx tsx main.ts

Or use it 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

It uses zod to validate that the input is a valid IPv4 address.

📚 Documentation

📁 Project Structure

.
├── geolocalizar.ts   # MCP Geolocalizar
├── onePiece.ts       # MCP OnePieceServer
├── package.json      # NPM configuration file
└── README.md         # This file

🧪 Development

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

📄 License

Not provided in the original document.

🧑‍💻 Author

Developed by 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