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