AI导哈

Pokémon信息查询服务

MCPoke Server是一个连接Pokémon API的Model Context Protocol (MCP)服务器，为Claude和其他AI助手提供全面的Pokémon信息查询功能，包括详细数据、搜索、类型效果计算等。

  • by Mgomez-01
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 mgomez-01/mcpoke-server

使用说明

克劳德桌面版MCPoke服务器

MCPoke服务器是一个模型上下文协议（MCP）服务器，连接到神奇宝贝API，使Claude和其他人工智能助手能够访问全面的神奇宝贝信息。此实现提供了与Claude Desktop的集成，以增强有关Pokemon的对话。

特性

  • 🔍 神奇宝贝详细信息：获取任何口袋妖怪的完整数据
  • 🔎 口袋妖怪搜索：按名称查找宝可梦
  • ⚔️ 类型信息：获得类型有效性和损伤关系
  • 💥 移动详细信息：查找移动统计数据、效果和属性
  • ✨ 能力信息：获取能力描述和拥有这些描述的口袋妖怪
  • 📊 宝可梦比较：并排比较多个口袋妖怪
  • 🧮 类型有效性计算器：计算战斗的类型匹配
  • 🧠 内存缓存：高效的请求缓存可减少API调用

安装

先决条件

  • Node.js 16+
  • npm包管理器
  • 克劳德桌面

安装步骤

  1. 克隆存储库

    git clone https://github.com/Mgomez-01/mcpoke-server.git
cd mcpoke-server

  2. 安装依赖项

    cd mcpoke-server
npm install

  3. 构建服务器

    npm run build

与Claude Desktop一起使用

配置

要将MCPoke服务器与Claude Desktop一起使用，您需要配置您的Claude Desktop应用程序：

  1. 找到您的Claude Desktop配置文件：

    • 窗户： %APPDATA%\Claude\claude_desktop_config.json
    • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux： ~/.config/Claude/claude_desktop_config.json

  2. 添加以下配置：

    {
  "mcpServers": {
    "mcpoke-server": {
      "command": "node",
      "args": ["/path/to/mcpoke-server/mcpoke-server/build/index.js"],
      "env": {}
    }
  }
}

    一定要更换 /path/to/mcpoke-server 使用系统上项目的实际路径。

  3. 重新启动Claude Desktop以应用更改。

使用示例

配置后，您可以向Claude询问有关Pokemon的问题，例如：

  • “你能告诉我皮卡丘的能力和数据吗？”
  • “Charizard比Venusaur有什么优势？”
  • “搜索名字中有'eon'的口袋妖怪”
  • “比较Blastoise和Feraligatr”
  • “‘恐吓’能力有什么作用？”
  • “告诉我霹雳的行动”
  • “对水/飞行宝可梦的电动攻击有多有效？”

在幕后，Claude使用MCPoke服务器提供的不同工具：

  • get_pokemon 有关Pokemon的详细信息
  • search_pokemon 通过名字找到宝可梦
  • compare_pokemon 用于并排比较
  • get_ability 获取能力信息
  • get_move 有关移动的详细信息
  • get_type 获取类型信息
  • get_type_effectiveness 用于计算战斗对决

启用调试模式后，您可以通过检查服务器日志实时查看这些交互。

测试和开发

使用MCP检查器

您可以直接使用MCP检查器工具测试服务器：

cd mcpoke-server
npm run inspector

然后使用示例请求 test_examples.md 文件。

调试

对于调试，您可以使用：

npm run debug

这将启动启用了Node.js检查器的服务器，允许您使用Chrome DevTools或Visual Studio Code调试服务器。MCPoke服务器还包括一个全面的调试日志系统。

详细的调试文档可在 DEBUGGING.md 包括：

  • 如何连接调试工具
  • 了解调试日志
  • 常见调试场景
  • 高级调试技术

未来的增强功能

虽然服务器功能齐全，但以下是（暂定）计划的增强功能：

  1. 测试：增加全面的单元和集成测试以提高可靠性
  2. 高级缓存：通过TTL优化实施更复杂的缓存策略
  3. 增强型系统：通过详细的发电特定机制改进类型有效性计算
  4. 稳健的错误处理：添加更全面的错误处理和边缘情况
  5. 扩展数据：添加对更多口袋妖怪数据的支持，如蛋群、栖息地、遭遇等。
  6. 高级搜索：实现复杂的搜索功能，按类型、统计数据、能力进行过滤
  7. 图像实用程序：添加精灵和图像工具，以获得更好的视觉表现
  8. 性能优化：优化API调用和响应处理以获得更快的结果
  9. 分页支持：为大型结果集添加分页
  10. 文档：创建详细的API文档和更多使用示例

致谢

  • PokéAPI 提供全面的口袋妖怪数据
  • 用于开发协议标准的模型上下文协议（MCP）社区
  • 所有宝可梦内容均为任天堂、Game Freak和宝可梦公司的知识产权

相关 MCP