MCP-Server (OnePieceServer & Geolocalizar)

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

📁 内容

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

⚙️ 要求

• Node.js ≥ 18
• npm ≥ 9

📦 安装依赖

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

🏴‍☠️ OnePieceServer MCP

📄 描述

OnePieceServer 允许查询来自《海贼王》动漫/漫画的角色信息，既可以单独查询也可以获取全部列表。

🚀 运行

bash
npx tsx onePiece.ts

你也可以使用MCP Inspector:

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

🛠 暴露的工具: one_piece

• 输入:
  json
  { "id": "1" }

  获取完整列表:
  json
  { "id": "todos" }

• 输出:
  json
  {
  "content": [
  {
  "type": "text",
  "text": "角色信息: { ... }"
  }
  ]
  }

🌐 使用的API

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

🌍 Geolocalizar MCP

📄 描述

Geolocalizar 允许获取公共IPv4地址的大致地理位置信息。

🚀 运行

bash
npx tsx main.ts

或者使用MCP Inspector:

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

🛠 暴露的工具: geolocalizar

• 输入:
  json
  { "ip": "8.8.8.8" }

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

🔐 验证

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

📁 项目结构

.
├── geolocalizar.ts # MCP 地理定位
├── onePiece.ts # MCP OnePieceServer
├── package.json # NPM配置文件
└── README.md # 本文件

🧪 开发

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

🧑‍💻 作者

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

通过Smithery安装

要通过Smithery自动为Claude Desktop安装OnePiece & Geolocalizar MCP Servers：

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