mcp-pokeapi-server

POKEAPI 与 MCP（模型上下文协议）规范结合，提供ポケモン情報取得ツールのサーバーです。

概要

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

設定

npm install

ビルド

npx tsc

開発用起動（ts-node）

npx ts-node src/index.ts

MCP クライアントからの利用方法

MCP クライアントや LLM アプリから、標準入力/出力を介して JSON-RPC リクエストを送信します。

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 入門