mcp-servers

🚀 MCP-Server (OnePieceServer & Geolocalizar)

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

🚀 快速开始

✨ 主要特性

本项目包含两个 MCP 服务器，分别为 OnePieceServer 和 Geolocalizar，它们的主要功能如下：

• OnePieceServer：可查询《海贼王》动漫/漫画中角色的信息，支持单个查询或获取全量列表。
• Geolocalizar：能够获取公共 IP 地址（IPv4）的大致地理信息。

📦 安装指南

⚙️ 要求

• 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": "角色信息: { ... }"
      }
    ]
  }
  

🌐 使用的 API

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

🌍 Geolocalizar MCP

📄 描述

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

🚀 运行

npx tsx main.ts

或者结合 MCP 检查器使用：

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 地址。

📚 详细文档

📁 项目内容

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

📁 项目结构

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

🧪 开发

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

📄 许可证

文档未提及许可证相关信息。

🧑‍💻 作者

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

通过 Smithery 安装

若要通过 Smithery 自动为 Claude Desktop 安装 OnePiece 和 Geolocalizar MCP 服务器，请执行以下命令：

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