MCP-Server (OnePieceServer & Geolocalizar)

此项目包含两个使用@modelcontextprotocol/sdk开发的MCP服务器。每个服务器都提供了一个有用的工具，可以被兼容MCP的客户端集成。

<a href="https://glama.ai/mcp/servers/@Haonter/MCP-Servers"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=1379374925,3930225298&fm=3081&app=3381&f=PNG?w=760&h=400" alt="Servers (OnePiece & Geolocalizar) MCP server" /> </a>

---

📁 内容

• onePiece.ts: 用于查询《海贼王》角色信息的MCP服务器
• geolocalizar.ts: 用于地理定位公共IP地址的MCP服务器

---

⚙️ 要求

• Node.js ≥ 18
• npm ≥ 9

📦 安装依赖

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

---

🏴‍☠️ OnePieceServer MCP

📄 描述

OnePieceServer允许查询《海贼王》动画/漫画中的角色信息，无论是单个角色还是整个列表。

🚀 运行

npx tsx onePiece.ts

也可以使用MCP Inspector：

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

🛠 暴露的工具：one_piece

• 输入：

  { "id": "1" }
  

  获取整个列表：

  { "id": "todos" }
  

• 输出：

  {
    "content": [
      {
        "type": "text",
        "text": "角色信息: { ... }"
      }
    ]
  }
  

🌐 使用的API

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

---

🌍 Geolocalizar 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\": \"美国\", ... }"
      }
    ]
  }
  

🔐 验证

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

---

📁 项目结构

.
├── geolocalizar.ts   # MCP Geolocalizar
├── onePiece.ts       # MCP OnePieceServer
├── package.json      # NPM配置文件
└── README.md         # 此文件

---

🧪 开发

两个服务器通过stdin和stdout使用StdioServerTransport进行通信，这使得它们可以从CLI轻松运行或与MCP客户端集成。

---

🧑‍💻 作者

由Diego Rodríguez开发
✉️ 联系方式：contacto@diegorodriguez.dev

---

通过Smithery安装

要通过Smithery自动安装OnePiece & Geolocalizar MCP服务器到Claude Desktop：

npx -y @smithery/cli install @Haonter/MCP-Servers --client claude