From 75e35cdcad22b26081b955110e61146d3add7eb5 Mon Sep 17 00:00:00 2001 From: joereg4 Date: Sun, 28 Sep 2025 12:16:17 -0500 Subject: [PATCH 1/3] Add PokeAPI MCP Server MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Comprehensive Pokémon data server with 9 tools - Docker image: joereg4/pokeapi-mcp-server:latest - Tools include: pokemon info, species, evolution chains, moves, abilities, items, types, locations, and machines - MIT licensed with full documentation - Source: https://github.com/joereg4/pokeapi-mcp-server --- servers/pokeapi.yaml | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 servers/pokeapi.yaml diff --git a/servers/pokeapi.yaml b/servers/pokeapi.yaml new file mode 100644 index 00000000..05386c41 --- /dev/null +++ b/servers/pokeapi.yaml @@ -0,0 +1,33 @@ +name: pokeapi +displayName: "PokeAPI MCP Server" +description: "Access comprehensive Pokémon data from PokeAPI with 9 specialized tools for stats, evolution chains, type effectiveness, and more" +author: "joereg4" +homepage: "https://github.com/joereg4/pokeapi-mcp-server" +license: "MIT" +image: "joereg4/pokeapi-mcp-server:latest" +sourceUrl: "https://github.com/joereg4/pokeapi-mcp-server" +tags: + - "pokemon" + - "gaming" + - "api" + - "entertainment" + - "data" +tools: + - name: "get_pokemon" + description: "Get detailed Pokémon information including stats, types, abilities, and sprites" + - name: "get_pokemon_species" + description: "Get species data including flavor text, evolution info, and capture rate" + - name: "get_evolution_chain" + description: "Get complete evolution chain information by chain ID" + - name: "get_type" + description: "Get type effectiveness and damage relations for Pokémon types" + - name: "get_machine" + description: "Get TM/HM/TR information including moves and availability" + - name: "get_pokedex" + description: "Get Pokédex entries and descriptions" + - name: "list_pokemon" + description: "List Pokémon with pagination support" + - name: "list_types" + description: "List all available Pokémon types" + - name: "search_pokemon_by_type" + description: "Find Pokémon of a specific type with filtering options" From 7a429fa7392ef8e3c09f96b48b9a05eac6b66175 Mon Sep 17 00:00:00 2001 From: joereg4 Date: Sun, 28 Sep 2025 12:20:49 -0500 Subject: [PATCH 2/3] Fix PokeAPI MCP Server structure - Move from servers/pokeapi.yaml to servers/pokeapi/server.yaml (proper structure) - Add tools.json with detailed tool definitions for all 9 tools - Follow Docker MCP Registry contributing guidelines correctly - Tools: get_pokemon, get_pokemon_species, get_evolution_chain, get_type, get_machine, get_pokedex, get_move, get_ability, get_item --- servers/pokeapi.yaml | 33 ------------ servers/pokeapi/server.yaml | 19 +++++++ servers/pokeapi/tools.json | 101 ++++++++++++++++++++++++++++++++++++ 3 files changed, 120 insertions(+), 33 deletions(-) delete mode 100644 servers/pokeapi.yaml create mode 100644 servers/pokeapi/server.yaml create mode 100644 servers/pokeapi/tools.json diff --git a/servers/pokeapi.yaml b/servers/pokeapi.yaml deleted file mode 100644 index 05386c41..00000000 --- a/servers/pokeapi.yaml +++ /dev/null @@ -1,33 +0,0 @@ -name: pokeapi -displayName: "PokeAPI MCP Server" -description: "Access comprehensive Pokémon data from PokeAPI with 9 specialized tools for stats, evolution chains, type effectiveness, and more" -author: "joereg4" -homepage: "https://github.com/joereg4/pokeapi-mcp-server" -license: "MIT" -image: "joereg4/pokeapi-mcp-server:latest" -sourceUrl: "https://github.com/joereg4/pokeapi-mcp-server" -tags: - - "pokemon" - - "gaming" - - "api" - - "entertainment" - - "data" -tools: - - name: "get_pokemon" - description: "Get detailed Pokémon information including stats, types, abilities, and sprites" - - name: "get_pokemon_species" - description: "Get species data including flavor text, evolution info, and capture rate" - - name: "get_evolution_chain" - description: "Get complete evolution chain information by chain ID" - - name: "get_type" - description: "Get type effectiveness and damage relations for Pokémon types" - - name: "get_machine" - description: "Get TM/HM/TR information including moves and availability" - - name: "get_pokedex" - description: "Get Pokédex entries and descriptions" - - name: "list_pokemon" - description: "List Pokémon with pagination support" - - name: "list_types" - description: "List all available Pokémon types" - - name: "search_pokemon_by_type" - description: "Find Pokémon of a specific type with filtering options" diff --git a/servers/pokeapi/server.yaml b/servers/pokeapi/server.yaml new file mode 100644 index 00000000..cc4988fc --- /dev/null +++ b/servers/pokeapi/server.yaml @@ -0,0 +1,19 @@ +name: pokeapi +image: joereg4/pokeapi-mcp-server:latest +type: server +meta: + category: entertainment + tags: + - pokemon + - gaming + - api + - entertainment + - data +about: + title: PokeAPI MCP Server + description: Access comprehensive Pokémon data from PokeAPI with 9 specialized tools for stats, evolution chains, type effectiveness, and more + icon: https://raw.githubusercontent.com/joereg4/pokeapi-mcp-server/main/icon.png +source: + project: https://github.com/joereg4/pokeapi-mcp-server +config: + description: No configuration required - connects directly to public PokeAPI diff --git a/servers/pokeapi/tools.json b/servers/pokeapi/tools.json new file mode 100644 index 00000000..8d8495b6 --- /dev/null +++ b/servers/pokeapi/tools.json @@ -0,0 +1,101 @@ +[ + { + "name": "get_pokemon", + "description": "Get detailed Pokémon information including stats, types, abilities, and sprites by name or ID", + "arguments": [ + { + "name": "identifier", + "type": "string", + "desc": "Pokémon name or ID (e.g., 'pikachu' or '25')" + } + ] + }, + { + "name": "get_pokemon_species", + "description": "Get species data including flavor text, evolution info, and capture rate", + "arguments": [ + { + "name": "identifier", + "type": "string", + "desc": "Pokémon species name or ID" + } + ] + }, + { + "name": "get_evolution_chain", + "description": "Get complete evolution chain information by chain ID", + "arguments": [ + { + "name": "chain_id", + "type": "string", + "desc": "Evolution chain ID (e.g., '1' for Bulbasaur line)" + } + ] + }, + { + "name": "get_type", + "description": "Get type effectiveness and damage relations for Pokémon types", + "arguments": [ + { + "name": "identifier", + "type": "string", + "desc": "Type name (e.g., 'fire', 'water', 'electric')" + } + ] + }, + { + "name": "get_machine", + "description": "Get TM/HM/TR information including moves and availability", + "arguments": [ + { + "name": "machine_id", + "type": "string", + "desc": "Machine ID (e.g., '1' for TM01)" + } + ] + }, + { + "name": "get_pokedex", + "description": "Get Pokédex entries and descriptions", + "arguments": [ + { + "name": "identifier", + "type": "string", + "desc": "Pokédex name or ID (e.g., 'national', 'kanto')" + } + ] + }, + { + "name": "get_move", + "description": "Get move information including power, accuracy, and effects", + "arguments": [ + { + "name": "identifier", + "type": "string", + "desc": "Move name or ID (e.g., 'thunderbolt', 'tackle')" + } + ] + }, + { + "name": "get_ability", + "description": "Get ability information including effects and Pokémon that have it", + "arguments": [ + { + "name": "identifier", + "type": "string", + "desc": "Ability name or ID (e.g., 'static', 'overgrow')" + } + ] + }, + { + "name": "get_item", + "description": "Get item information including effects and usage", + "arguments": [ + { + "name": "identifier", + "type": "string", + "desc": "Item name or ID (e.g., 'poke-ball', 'master-ball')" + } + ] + } +] From 3b4d0833486dcfc92460bd2c5436a8b3b8f64b57 Mon Sep 17 00:00:00 2001 From: joereg4 Date: Sun, 28 Sep 2025 12:28:38 -0500 Subject: [PATCH 3/3] Fix PokeAPI server icon URL - Change from non-existent icon.png to working Pikachu sprite - Validation now passes completely with all green checkmarks - Build command successfully validates 9 tools --- servers/pokeapi/server.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/servers/pokeapi/server.yaml b/servers/pokeapi/server.yaml index cc4988fc..5529b76e 100644 --- a/servers/pokeapi/server.yaml +++ b/servers/pokeapi/server.yaml @@ -12,7 +12,7 @@ meta: about: title: PokeAPI MCP Server description: Access comprehensive Pokémon data from PokeAPI with 9 specialized tools for stats, evolution chains, type effectiveness, and more - icon: https://raw.githubusercontent.com/joereg4/pokeapi-mcp-server/main/icon.png + icon: https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/25.png source: project: https://github.com/joereg4/pokeapi-mcp-server config: