Pokemon

A Model Context Protocol (MCP) server that provides Pokemon data through standardized tools. This monorepo contains both the MCP server and data ingestion service for fetching Pokemon data from PokeAPI.

This is a PNPM monorepo with two main packages:

- pokemon-mcp-server: MCP server that exposes Pokemon data through standardized tools
- pokemon-mcp-ingestion: Data ingestion service that fetches from PokeAPI and stores in SQLite

The system uses a shared SQLite database (data/pokemon.sqlite) for Pokemon data storage.

- get_pokemon- Get detailed information about a specific Pokemon
- search_pokemon- Search Pokemon by name, type, or other criteria
- get_strongest_pokemon- Find the strongest Pokemon by various stats
- get_pokemon_stats- Get detailed stats for a Pokemon
- compare_pokemon- Compare stats between two Pokemon
- get_type_effectiveness- Get type effectiveness information

- Complete Pokemon data from PokeAPI
- Stats, types, abilities, and more
- Type effectiveness relationships
- Searchable by multiple criteria

git clone https://github.com/grovesjosephn/pokemcp.git cd pokemcp

# Development mode (with hot reload) bun run dev # Production mode cd packages/pokemon-mcp-server bun run start

# Visual GUI testing cd packages/pokemon-mcp-server bun run inspect # CLI testing bun run inspect:cli

# Run data ingestion cd packages/pokemon-mcp-ingestion bun run start

cd packages/pokemon-mcp-server bun run build npm link

{ "mcpServers": { "pokemon": { "command": "pokemon-mcp-server", "env": { "POKEMON_DATA_DIR": "/path/to/pokemcp/data" } } } }

{ "mcpServers": { "pokemon": { "command": "node", "args": ["/path/to/pokemcp/packages/pokemon-mcp-server/dist/server.js"], "env": { "POKEMON_DATA_DIR": "/path/to/pokemcp/data" } } } }

{ "mcpServers": { "pokemon": { "command": "bun", "args": ["/path/to/pokemcp/packages/pokemon-mcp-server/server.ts"], "env": { "POKEMON_DATA_DIR": "/path/to/pokemcp/data" } } } }

bun run build # Build all packages bun run dev # Run all packages in development mode bun run test # Run tests for all packages bun run format # Format all files bun run format:check # Check formatting

cd packages/pokemon-mcp-server bun run build # Compile TypeScript bun run dev # Watch mode bun run start # Run server bun run inspect # Run MCP Inspector GUI bun run inspect:cli # Run MCP Inspector CLI bun test # Run tests

cd packages/pokemon-mcp-ingestion bun run build # Compile TypeScript bun run dev # Watch mode bun run start # Run ingestion bun test # Run tests

The project uses bun's built-in test runner:

# Run all tests bun run test # Run specific package tests cd packages/pokemon-mcp-server && bun test cd packages/pokemon-mcp-ingestion && bun test

The SQLite database includes tables for:

- pokemon- Basic Pokemon information
- stats- Pokemon stats (HP, Attack, Defense, etc.)
- types- Pokemon types and relationships
- abilities- Pokemon abilities
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- Runbun run format
- Submit a pull request

<type>[optional scope]: <description> Examples: - feat(server): add Pokemon evolution chain tool - fix(ingestion): handle missing species URL gracefully - docs: update integration guide

MIT License - see LICENSE file for details

- Model Context Protocol
- PokeAPI
- Claude Desktop

An MCP server for '海龟汤' (Turtle Soup), a scenario-based reasoning puzzle game.