PokéAPI MCP服务器

一个基于TypeScript的模型上下文协议(MCP)服务器,为AI助手提供完整的PokéAPI访问能力,包含1300+物种、900+招式、300+特性和18种类型的数据。

  • by bhayanak
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bhayanak/pokemon-mcp-server

使用说明

PokéAPI MCP Server

Give your AI assistant access to the entire Pokémon universe


A. 模型上下文协议(MCP)服务器 在封装的TypeScript中 PokéAPI v2 -最大的神奇宝贝RESTful API(1300+种,900+移动,300+能力,18种类型)。船既是 npm包 和一个 VS代码扩展.

包裹

包装 描述 文档
pokeapi-mcp-server MCP服务器(npm/CLI) 自述文件→
pokeapi-mcp-extension VS代码扩展 自述文件→

快速开始

选项1:VS代码扩展(推荐)

从市场安装——扩展会自动处理一切:

ext install bhayanak.pokeapi-mcp-extension

VS Code提供内置 启动/停止/重新启动 控制。您的AI助手可以立即访问所有12个工具。

选项2:npm/CLI

npm install -g pokeapi-mcp-server
pokeapi-mcp-server

或者与Claude Desktop一起使用:

{
  "mcpServers": {
    "pokeapi": {
      "command": "npx",
      "args": ["-y", "pokeapi-mcp-server"]
    }
  }
}

12个MCP工具

类别 工具 它们的作用
宝可梦 pokemon_get, pokemon_search 按类型/代查找和搜索
类型 pokemon_get_type, pokemon_type_matchup 类型详细信息和有效性计算器
移动 pokemon_get_move, pokemon_search_moves 移动数据库和筛选搜索
能力 pokemon_get_ability 能力效果和宝可梦列表
进化 pokemon_get_evolution_chain 具有条件的完全进化树
物种 pokemon_get_species 风味文本、栖息地、蛋群
物品 pokemon_get_item 项目详细信息、效果、类别
分析 pokemon_compare, pokemon_type_coverage 并排统计数据和球队报道

许可证

麻省理工学院 ©bhayanak

快速开始

# Install dependencies
pnpm install

# Build all packages
pnpm run build

# Run the MCP server (stdio mode)
cd packages/pokeapi-server && pnpm run dev

MCP工具

工具 说明
pokemon_get 获取详细的宝可梦数据(属性、类型、能力、动作)
pokemon_search 按类型、世代或浏览搜索宝可梦
pokemon_get_type 获取类型详细信息和损坏关系
pokemon_type_matchup 检查类型有效性
pokemon_get_move 获取移动细节(力量、精度、效果)
pokemon_search_moves 按条件搜索移动
pokemon_get_ability 获取能力详细信息
pokemon_get_evolution_chain 获取有条件的进化链
pokemon_get_species 获取物种数据(风味文本、栖息地、捕获率)
pokemon_get_item 获取商品详细信息
pokemon_compare 并排比较2-4个口袋妖怪
pokemon_type_coverage 分析团队类型覆盖率

配置

变量 默认值 描述
POKEAPI_MCP_BASE_URL https://pokeapi.co/api/v2 API基本URL
POKEAPI_MCP_CACHE_TTL_MS 86400000 (24小时) 缓存TTL
POKEAPI_MCP_CACHE_MAX_SIZE 500 最大缓存条目数
POKEAPI_MCP_TIMEOUT_MS 10000 HTTP超时
POKEAPI_MCP_LANGUAGE en 首选语言

发展

pnpm run typecheck   # TypeScript type checking
pnpm run lint        # ESLint with security rules
pnpm run test        # Run tests
pnpm run build       # Build all packages

许可证

麻省理工学院