Skip to main content
Glama
grovesjosephn

Pokemon MCP Server

宝可梦 MCP 服务器

一个通过标准化工具提供宝可梦数据的模型上下文协议 (MCP) 服务器。此 monorepo 包含用于从 PokeAPI 获取宝可梦数据的 MCP 服务器和数据摄取服务。

架构

这是一个包含两个主要包的 PNPM monorepo:

  • pokemon-mcp-server:通过标准化工具公开宝可梦数据的 MCP 服务器

  • pokemon-mcp-ingestion:从 PokeAPI 获取数据并存储到 SQLite 的数据摄取服务

该系统使用共享的 SQLite 数据库 (data/pokemon.sqlite) 来存储宝可梦数据。

Related MCP server: PokeMCP

功能

可用的 MCP 工具

  • get_pokemon - 获取特定宝可梦的详细信息

  • search_pokemon - 按名称、类型或其他标准搜索宝可梦

  • get_strongest_pokemon - 按各种属性查找最强的宝可梦

  • get_pokemon_stats - 获取宝可梦的详细属性

  • compare_pokemon - 比较两只宝可梦的属性

  • get_type_effectiveness - 获取属性克制信息

数据覆盖范围

  • 来自 PokeAPI 的完整宝可梦数据

  • 属性、类型、特性等

  • 属性克制关系

  • 可通过多种标准进行搜索

快速入门

先决条件

  • Node.js 18+

  • PNPM

  • Git

安装

  1. 克隆仓库:

git clone https://github.com/grovesjosephn/pokemcp.git
cd pokemcp
  1. 安装依赖:

bun install
  1. 设置数据库:

./scripts/setup.sh
  1. 构建所有包:

bun run build

使用方法

运行 MCP 服务器

# Development mode (with hot reload)
bun run dev

# Production mode
cd packages/pokemon-mcp-server
bun run start

使用 MCP Inspector 进行测试

# 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

Claude Desktop 集成

选项 1:NPM 包(推荐)

全局安装服务器:

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

配置 Claude Desktop:

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

选项 2:直接 Node 执行

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

选项 3:开发模式

{
  "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

测试

该项目使用 bun 内置的测试运行器:

# Run all tests
bun run test

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

数据库架构

SQLite 数据库包含以下表:

  • pokemon - 宝可梦基本信息

  • stats - 宝可梦属性(HP、攻击、防御等)

  • types - 宝可梦类型和关系

  • abilities - 宝可梦特性

贡献

  1. Fork 本仓库

  2. 创建功能分支

  3. 进行更改

  4. 添加测试

  5. 运行 bun run format

  6. 提交拉取请求

提交指南

使用约定式提交格式:

<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 文件

链接

F
license - not found
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    An MCP server that provides detailed Pokémon information by integrating with the PokeAPI, allowing users to fetch comprehensive data about Pokémon and simulate battles.
    2
    2
  • F
    license
    Not graded
    quality
    D
    maintenance
    An MCP (Multi-Agent Conversation Protocol) Server that provides an interface to access Pokémon data through the PokéAPI, enabling agents to retrieve information about Pokémon species, abilities, moves, and more via natural language.
  • F
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that provides comprehensive Pokemon data and battle simulation capabilities to AI assistants. It enables users to access detailed stats, types, and moves while simulating battles with realistic mechanics like type effectiveness and status effects.

View all related MCP servers

Related MCP Connectors

  • GibsonAI MCP server: manage your databases with natural language

  • Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.

  • An MCP server that integrates with Discord to provide AI-powered features.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/grovesjosephn/pokemcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server