MCP Servers

🚀 MCP-Server (OnePieceServer & Geolocalizar)

このプロジェクトには、@modelcontextprotocol/sdkを使用して開発された2つのMCPサーバーが含まれています。それぞれが、MCP互換のAIクライアントによって統合可能な便利なツールを公開しています。

🚀 クイックスタート

このMCP-Serverは、One Pieceのキャラクター情報を取得するOnePieceServerと、IPアドレスの地理的位置情報を取得するGeolocalizarの2つのサーバーで構成されています。以下にそれぞれのセットアップと使用方法を説明します。

✨ 主な機能

• OnePieceServerを使用して、One Pieceのキャラクター情報を取得できます。
• Geolocalizarを使用して、IPv4のIPアドレスの地理的位置情報を取得できます。

📦 インストール

⚙️ 必要条件

• Node.js ≥ 18
• npm ≥ 9

📦 依存関係のインストール

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

💻 使用例

🏴‍☠️ OnePieceServer MCP

📄 説明

OnePieceServerを使用すると、アニメ/マンガ「One Piece」のキャラクター情報を個別に、または利用可能な全リストを取得できます。

🚀 実行

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を使用すると、パブリックなIPv4のIPアドレスの地理的位置情報を取得できます。

🚀 実行

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アドレスであることを検証します。

📚 ドキュメント

📁 プロジェクト構造

.
├── 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