Poke-MCP

概述

Poke-MCP 是一个模型上下文协议 (MCP) 服务器，它通过标准化的接口提供宝可梦（Pokémon）信息。它连接到 PokeAPI 来获取宝可梦数据，并通过 MCP 工具公开这些数据，这些工具可以被任何 MCP 兼容的客户端使用，例如 Claude Desktop App、Continue、Cline 等。

特性

• 通过名称获取特定宝可梦的信息
• 发现随机宝可梦
• 从特定地区（关都、城都、丰缘等）查找随机宝可梦
• 获取特定属性（火、水、电等）的随机宝可梦
• 用于宝可梦信息的自然语言查询界面

工作原理

Poke-MCP 使用 模型上下文协议 构建，该协议使 AI 应用程序能够以标准化的方式访问外部工具和数据源。服务器：

1. 连接到 PokeAPI 以获取宝可梦数据
2. 通过 MCP 接口公开多个工具
3. 处理来自 MCP 客户端的请求
4. 返回格式化的宝可梦信息

MCP 工具

服务器提供以下工具：

• get-pokemon：获取关于特定宝可梦的详细信息（通过名称）
• random-pokemon：获取关于随机宝可梦的信息
• random-pokemon-from-region：获取来自特定地区的随机宝可梦
• random-pokemon-by-type：获取特定属性的随机宝可梦
• pokemon-query：回答关于宝可梦的自然语言查询

架构

服务器使用以下技术构建：

• TypeScript
• MCP TypeScript SDK (@modelcontextprotocol/sdk)
• Zod 用于输入验证
• 标准 I/O 传输用于 MCP 通信

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Pokémcp：

npx -y @smithery/cli install @NaveenBandarage/poke-mcp --client claude

手动安装

# 克隆仓库
git clone https://github.com/yourusername/poke-mcp.git
cd poke-mcp

# 安装依赖
npm install

# 构建项目
npm run build

用法

与 Claude Desktop App 一起使用

1. 下载并安装 Claude Desktop App
2. 打开 Claude Desktop 设置
3. 转到开发者设置并编辑配置文件
4. 添加以下配置：

{
  "mcpServers": {
    "pokedex": {
      "command": "path/to/poke-mcp/build/index.js"
    }
  }
}

5. 重启 Claude Desktop
6. 现在您应该在 Claude 中看到可用的宝可梦工具

示例查询

连接到 MCP 客户端后，您可以提出如下问题：

• "告诉我关于皮卡丘的信息"
• "给我一个随机宝可梦"
• "给我展示一个来自关都的随机宝可梦"
• "什么是随机的水属性宝可梦？"

项目结构

• src/index.ts：主服务器实现
• src/types.ts：宝可梦数据的 TypeScript 类型定义
• package.json：项目依赖和脚本
• tsconfig.json：TypeScript 配置

添加新功能

要添加新工具或增强现有工具：

1. 定义新的辅助函数来获取和格式化数据
2. 使用 server.tool() 方法注册新工具
3. 实现工具逻辑以处理请求并返回响应

许可证

ISC

致谢

• PokeAPI 提供宝可梦数据
• 模型上下文协议 提供标准化接口

---

该项目演示了如何构建自定义 MCP 服务器，这些服务器可以使用特定领域的知识和功能来扩展 AI 助手。