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

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

📁 内容

• onePiece.ts：用于查询海贼王角色的 MCP 服务器

• geolocalizar.ts：用于对公共 IP 地址进行地理定位的 MCP 服务器

Related MCP server: MyAnimeList MCP Server

⚙️ 要求

• Node.js ≥ 18

• npm≥9

📦安装依赖项

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

🏴‍☠️ OnePieceServer MCP

📄 描述

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

🚀 运行

npx tsx onePiece.ts

您还可以使用 MCP 检查器：

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

🛠 暴露的工具： 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）地址获取大致的地理信息。

🚀 运行

npx tsx main.ts

或者与 MCP Inspector 一起使用：

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

🛠 公开工具： geolocalizar

• 输入：

  { "ip": "8.8.8.8" }

• 输出：

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

🔐 验证

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

📁 项目结构

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

🧪 开发

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

🧑‍💻作者

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