Pokémon MCP

MCP server mínimo con tools contra PokéAPI, sin UI todavía.

Sigue el flujo de la documentación de OpenAI (Build an MCP server): primero tools + HTTP streamable, después UI.

Requisitos

• Node.js 18+

Related MCP server: Pokemon MCP Server

Instalación

npm install

Tools

Todas son read-only y consultan la API pública de PokéAPI (openWorldHint: true).

Ejecutar

Cursor (stdio)

npm run dev

Configuración MCP en Cursor. Sustituye PATH_TO_REPO por la ruta absoluta de este proyecto:

{
  "mcpServers": {
    "pokemon-mcp": {
      "command": "node",
      "args": [
        "./node_modules/tsx/dist/cli.mjs",
        "src/index.ts"
      ],
      "cwd": "PATH_TO_REPO"
    }
  }
}

Si Cursor no encuentra node (por ejemplo con nvm), usa la ruta absoluta de tu binario de Node en command.

ChatGPT / Inspector (HTTP en /mcp)

npm run dev:http

Deberías ver: Pokémon MCP server listening on http://localhost:8787/mcp

Probar con MCP Inspector:

npx @modelcontextprotocol/inspector@latest --server-url http://localhost:8787/mcp --transport http

Smoke test

npm run smoke

Siguiente paso

Cuando las tools funcionen end-to-end, puedes añadir UI con Add UI to your MCP server (registerAppTool + resource HTML).