Pokemon信息查询工具

一个基于PokeAPI的Model Context Protocol (MCP)服务器,提供Pokemon相关信息查询功能,包括Pokemon信息、种族信息、类型信息、技能信息、特性信息、进化链信息等。

  • by Ippei523
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ippei523/pokemon-mcp-server

使用说明

口袋妖怪MCP服务器

PokeAPI利用期间Model Context Protocol (MCP)服务器。Pokemon中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。

机能

  • Pokemon获取信息
  • Pokemon获取种族信息
  • Pokemon获取类型信息
  • Pokemon技能情报的取得
  • Pokemon获取特性信息
  • 获取进化链信息
  • Pokemon検索
  • Pokemon获取列表(支持分页)

安装

npm install

构建

npm run build

开発

以开发模式运行

npm run dev

构建并运行

npm run build
npm start

测试

所有测试运行

npm test

仅限单体测试

npm run test:unit

E2E仅测试

npm run test:e2e

测试覆盖

npm run test:coverage

集成测试API),模板名称将采用不同的格式

npm run test:integration

MCP 客户端使用

Claude Desktop 中的设置

Claude Desktop 的配置文件(claude_desktop_config.json)中添加以下内容:

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["/path/to/pokemon-mcp-server/dist/index.js"]
    }
  }
}

可用工具

  1. get_pokemon - Pokemon情报取得

    引数: name (string) - Pokemon名
    
  2. get_pokemon_type - Pokemon类型信息检索

    引数: name (string) - タイプ名
    
  3. get_move 宝可梦技情報取得

    引数: name (string) - 技名
    
  4. 获取能力 - Pokemon特性情报取得

    引数: name (string) - 特性名
    
  5. get_evolution_chain -获取进化链信息

    引数: id (number) - 進化チェーンID
    
  6. search_pokemon - Pokemon検索

    引数: query (string) - 検索クエリ
    
  7. get_pokemon_list - Pokemon列表检索

    引数: limit (number, optional) - 取得件数(デフォルト: 20)
          offset (number, optional) - オフセット(デフォルト: 0)
    

使用例

Claude Desktop 在这里MCP配置服务器后,您可以问:

  • “请告诉我皮卡丘的信息”
  • “关于火焰类型的口袋妖怪”
  • “告诉我十万伏特的技术”
  • “请告诉我静电的特性”
  • "pika搜索以开头的口袋妖怪“

项目结构

src/
├── client/          # PokeAPI クライアント
│   └── pokeapi-client.ts
├── server/          # MCP サーバー設定
│   └── mcp-server.ts
├── tools/           # ツール定義とハンドラー
│   ├── tool-definitions.ts
│   └── tool-handlers.ts
├── config/          # 設定ファイル
│   └── server-config.ts
├── types/           # TypeScript 型定義
│   ├── index.ts
│   ├── common.ts
│   ├── pokemon.ts
│   ├── species.ts
│   ├── type.ts
│   ├── move.ts
│   ├── ability.ts
│   └── evolution.ts
└── index.ts         # エントリーポイント

依存关系

  • @modelcontextprotocol/sdk -MCP-SDK
  • axios - HTTP 客户机

开発依存关系

  • typescript - TypeScript 编译程序
  • jest -测试框架
  • ts-jest - Jest TypeScript 支持
  • nock - HTTP 拖曳
  • @types/node - Node.js 型定义

许可证

麻省理工学院