MCP Pokeapi Server

🚀 mcp-pokeapi-server

このサーバーは、POKEAPI と MCP（モデルコンテキストプロトコル）規範を組み合わせて、ポケモン情報取得ツールを提供します。

🚀 クイックスタート

このサーバーは、MCP プロトコル（JSON - RPC 2.0 over stdio）を用いて、LLM アプリや MCP クライアントからポケモン情報を取得するツールを提供します。POKEAPI（https://pokeapi.co/）を利用しており、模式検証にはzodを使用しています。

✨ 主な機能

• MCP プロトコルを通じて、LLM アプリや MCP クライアントからのポケモン情報取得をサポート。
• POKEAPI を利用してポケモン情報を取得。
• zod を使用した模式検証。

📦 インストール

npm install

📦 ビルド

npx tsc

📦 開発用起動（ts - node）

npx ts-node src/index.ts

💻 使用例

基本的な使用法

1. ツール一覧取得（list_tools）

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "list_tools"
}

応答例

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "getPokemonInfo",
        "description": "ポケモン名またはIDから、POKEAPIでポケモン情報を取得します。",
        "input_schema": { ... },
        "output_schema": { ... }
      }
    ]
  }
}

2. ポケモン情報取得（call_tool）

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "call_tool",
  "params": {
    "name": "getPokemonInfo",
    "arguments": {
      "nameOrId": "pikachu"
    }
  }
}

応答例

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "json",
        "data": {
          "name": "pikachu",
          "id": 25,
          "height": 4,
          "weight": 60,
          "types": ["electric"]
        }
      }
    ]
  }
}

📦 テスト

npm test

📚 ドキュメント

参考資料

• MCP 公式ドキュメント
• POKEAPI 公式サイト
• Zenn: MCP 入門