Pokemon Paste MCP

🚀 ポケモンペーストMCPサーバー

ポケモンのペースト（ポケペースト）を作成するためのMCPサーバーです。

📦 インストール

npmからのインストール（推奨）

npm install -g pokemon-paste-mcp

ソースからのインストール

npm install
npm run build

💻 使用例

基本的な使用法

このサーバーはcreate_pokepasteツールを提供しており、ポケモンのセットデータを受け取り、ポケペーストのURLを作成します。

ツール：create_pokepaste

ポケモンのセットオブジェクトの配列からポケペーストを作成します。

パラメーター:

• pokemon (配列, 必須): ポケモンのセットオブジェクトの配列
• title (文字列, オプション): ペーストのタイトル
• author (文字列, オプション): 作者名
• notes (文字列, オプション): 追加のメモ

ポケモンセットオブジェクトの構造:

{
  "name": "string",
  "species": "string", 
  "item": "string",
  "ability": "string",
  "moves": ["string", "string", "string", "string"],
  "nature": "string",
  "gender": "string",
  "evs": {
    "hp": 0,
    "atk": 252,
    "def": 0,
    "spa": 4,
    "spd": 0,
    "spe": 252
  },
  "ivs": {
    "hp": 31,
    "atk": 31,
    "def": 31,
    "spa": 31,
    "spd": 31,
    "spe": 31
  },
  "level": 50,
  "shiny": false,
  "happiness": 255,
  "pokeball": "Poke Ball",
  "hpType": "Electric",
  "dynamaxLevel": 10,
  "gigantamax": false,
  "teraType": "Electric"
}

使用例:

{
  "pokemon": [
    {
      "name": "Pikachu",
      "species": "Pikachu",
      "item": "Light Ball",
      "ability": "Static",
      "moves": ["Thunderbolt", "Quick Attack", "Iron Tail", "Agility"],
      "nature": "Jolly",
      "gender": "M",
      "evs": { "hp": 0, "atk": 252, "def": 0, "spa": 4, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 31, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50
    }
  ],
  "title": "My Team",
  "author": "Trainer"
}

MCPクライアントの設定

MCPクライアント（Claude Desktop、Cursorなど）を設定します。

リモートnpmパッケージを使用する場合:

{
  "mcpServers": {
    "pokemon-paste": {
      "command": "npx",
      "args": ["pokemon-paste-mcp"],
      "env": {}
    }
  }
}

ローカル開発の場合:

{
  "mcpServers": {
    "pokemon-paste": {
      "command": "node",
      "args": ["/path/to/pokemon-paste-mcp/dist/index.js"],
      "env": {}
    }
  }
}

🔧 テスト

ローカルMCPツールのテスト

MCPインスペクターを使用して、ローカルのMCPサーバーをテストすることができます。

npm run build
npx @modelcontextprotocol/inspector node path/to/pokemon-paste-mcp/dist/index.js

MCPクライアントで直接MCPサーバーをテストしたい場合は、以下の完全なテスト入力を使用します。

{
  "pokemon": [
    {
      "name": "Pikachu",
      "species": "Pikachu",
      "item": "Light Ball",
      "ability": "Static",
      "moves": ["Thunderbolt", "Quick Attack", "Iron Tail", "Agility"],
      "nature": "Jolly",
      "gender": "M",
      "evs": { "hp": 0, "atk": 252, "def": 0, "spa": 4, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 31, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "shiny": false
    },
    {
      "name": "Charizard",
      "species": "Charizard",
      "item": "Charcoal",
      "ability": "Blaze",
      "moves": ["Flamethrower", "Air Slash", "Solar Beam", "Roost"],
      "nature": "Modest",
      "gender": "M",
      "evs": { "hp": 4, "atk": 0, "def": 0, "spa": 252, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 0, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "teraType": "Fire"
    },
    {
      "name": "Alakazam",
      "species": "Alakazam",
      "item": "Life Orb",
      "ability": "Magic Guard",
      "moves": ["Psychic", "Focus Blast", "Shadow Ball", "Recover"],
      "nature": "Timid",
      "gender": "M",
      "evs": { "hp": 4, "atk": 0, "def": 0, "spa": 252, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 0, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "shiny": true,
      "pokeball": "Ultra Ball"
    }
  ],
  "title": "Sample Competitive Team",
  "author": "Pokemon Trainer",
  "notes": "A balanced team with Pikachu as the main attacker, Charizard for coverage, and Alakazam for special sweeping."
}

このテスト入力には以下が含まれています。

• 異なる役割を持つ3匹の多様なポケモン
• 様々なオプションフィールド（shiny、teraType、pokeball）
• 対戦用のサンプルEV/IVスプレッド
• チームのメタデータ（タイトル、作者、メモ）

期待される出力は、整形されたチームを見ることができるポケペーストのURLです。

📝 作者のメッセージ

このプロジェクトの進捗状況に興味がある方は、リポジトリをフォローして最新情報をゲットしてください！

このプロジェクトに関して私に連絡を取りたい場合は、以下のいずれかの方法でお気軽にご連絡ください。

• メール: professor.ragna@gmail.com
• Twitter: @professorragna

このプロジェクトの資金提供に興味がある方は、こちらから支援することができます。どんな支援も大歓迎です！

📄 ライセンス

MIT