项目概述

Poke-MCP 是一个基于模型上下文协议（MCP）构建的服务，通过统一接口提供 Pokémon 信息。该服务连接到 PokeAPI 获取 Pokémon 数据，并通过 MCP 工具为任何兼容客户端（如 Claude 桌面应用、Continue、Cline 等）提供数据支持。

功能特点

• 通过名称查询特定 Pokémon 的详细信息
• 随机获取 Pokémon 信息
• 根据地区查找随机 Pokémon（如卡洛斯、丰缘、神奥等）
• 按类型筛选随机 Pokémon（如火、水、电等）
• 支持自然语言查询 Pokémon 相关问题

工作原理

Poke-MCP 使用 模型上下文协议，实现 AI 应用程序与外部数据源的标准化交互。服务流程如下：

1. 连接到 PokeAPI 获取 Pokémon 数据
2. 通过 MCP 接口暴露多个工具
3. 处理 MCP 客户端请求
4. 返回格式化 Pokémon 信息

MCP 工具

Poke-MCP 提供以下工具：

• get-pokemon：根据名称获取特定 Pokémon 的详细信息
• random-pokemon：随机获取一个 Pokémon 信息
• random-pokemon-from-region：按地区随机获取 Pokémon
• random-pokemon-by-type：按类型随机获取 Pokémon
• pokemon-query：回答关于 Pokémon 的自然语言查询

架构设计

服务采用以下技术构建：

• TypeScript
• MCP TypeScript SDK (@modelcontextprotocol/sdk)
• Zod 进行输入验证
• 标准 I/O 传输协议实现 MCP 通信

安装指南

使用 Smithery 快速安装

通过 Smithery 自动为 Claude 桌面应用安装 Poke-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 桌面应用中使用

1. 下载并安装 Claude 桌面应用
2. 打开 Claude 设置界面
3. 进入开发者设置，编辑配置文件
4. 添加以下配置：

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

5. 重启 Claude 桌面应用
6. 现在您应该可以看到 Pokémon 工具已集成到 Claude

示例查询

连接到 MCP 客户端后，可以执行以下命令：

• "告诉我关于皮卡丘的信息"
• "给我一个随机的精灵"
• "展示一个来自卡洛斯地区的随机精灵"
• "有什么水属性的精灵？"

项目结构

• src/index.ts：主服务实现
• src/types.ts：TypeScript 类型定义文件
• package.json：项目依赖及脚本信息
• tsconfig.json：TypeScript 配置文件

扩展新功能

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

1. 定义新的辅助函数以获取和格式化数据
2. 使用 server.tool() 方法注册新工具
3. 实现具体的业务逻辑

项目许可

本项目遵循 MIT 许可证协议。