MCP Servers (OnePiece & Geolocalizar)

MCP 服务器 (OnePieceServer 和地理定位)

该项目包含两个使用@modelcontextprotocol/sdk开发的 MCP 服务器。每个都公开了一个可由 MCP 兼容的 AI 客户端集成的有用工具。

📁 内容

• onePiece.ts：用于查询海贼王角色的 MCP 服务器
• geolocalizar.ts：用于对公共 IP 地址进行地理定位的 MCP 服务器

⚙️ 要求

• Node.js ≥ 18
• npm≥9

📦安装依赖项

🏴‍☠️ OnePieceServer MCP

📄 描述

OnePieceServer允许您查看动漫/漫画《海贼王》中人物的信息，可以单独查看，也可以从整个可用列表中查看。

🚀 运行

您还可以使用 MCP 检查器：

🛠 暴露的工具： one_piece

• 输入：
  { "id": "1" }
  完整列表：
  { "id": "todos" }
• 输出：
  { "content": [ { "type": "text", "text": "Información del personaje: { ... }" } ] }

🌐 使用的 API

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

🌍 地理定位 MCP

📄 描述

Geolocalizar允许您从公共 IP（IPv4）地址获取大致的地理信息。

🚀 运行

或者与 MCP Inspector 一起使用：

🛠 公开工具： geolocalizar

• 输入：
  { "ip": "8.8.8.8" }
• 输出：
  { "content": [ { "type": "text", "text": "{ \"ip\": \"8.8.8.8\", \"country\": \"United States\", ... }" } ] }

🔐 验证

使用zod验证输入是否为 IPv4 格式的有效 IP。

📁 项目结构

🧪 开发

两个服务器都使用StdioServerTransport通过stdin和stdout进行通信，从而允许从 CLI 轻松执行或与 MCP 客户端集成。

🧑‍💻作者

由Diego Rodríguez开发
✉️ contacto@diegorodriguez.dev