MCP-Server (OnePieceServer & Geolocalizar)

What is MCP-Server (OnePieceServer & Geolocalizar)?

A collection of two MCP servers built with @modelcontextprotocol/sdk. OnePieceServer queries character data from the One Piece anime/manga, and Geolocalizar retrieves approximate geographic information for a public IPv4 address. Designed for integration with any AI client that supports the Model Context Protocol.

How to use MCP-Server (OnePieceServer & Geolocalizar)?

Requires Node.js ≥18 and npm ≥9. Install dependencies with npm install @modelcontextprotocol/sdk axios zod and optionally npm install -D tsx. Run OnePieceServer with npx tsx onePiece.ts and Geolocalizar with npx tsx main.ts. Both can also be launched via the MCP Inspector: npx -y @modelcontextprotocol/inspector npx -y tsx onePiece.ts (or main.ts). The servers communicate over stdin/stdout using StdioServerTransport.

Key features of MCP-Server (OnePieceServer & Geolocalizar)

• Exposes two MCP tools: one_piece and geolocalizar
• OnePiece tool returns a character by ID or full list
• Geolocalizar tool returns IP location data (country, city, etc.)
• Input validated with Zod (IPv4 format for geolocation)
• Both servers are standalone and run directly via tsx

Use cases of MCP-Server (OnePieceServer & Geolocalizar)

• Look up details of a specific One Piece character by ID
• Retrieve the full list of available One Piece characters
• Determine the approximate geographic location of a public IP address

FAQ from MCP-Server (OnePieceServer & Geolocalizar)

What are the runtime requirements?

Node.js version 18 or higher and npm version 9 or higher are required.

How do I install the project dependencies?

Run npm install @modelcontextprotocol/sdk axios zod and optionally npm install -D tsx for execution.

What external APIs does it use?

OnePieceServer queries https://onepieceapi-50cm.onrender.com/personaje/{id} for single characters and https://onepieceapi-50cm.onrender.com/personajes for the full list. Geolocalizar does not specify its API endpoints.

How is user input validated?

Geolocalizar uses Zod to ensure the ip field is a valid IPv4 address. OnePieceServer expects an id field (string or “todos”).

Can I run these servers with the MCP Inspector?

Yes. Use npx -y @modelcontextprotocol/inspector npx -y tsx <script>.ts for either server.