JinDaGe - Pokémon Data MCP Details

article

README

🚀 Poke - MCP

Poke - MCP 是一个基于模型上下文协议（MCP）构建的服务，它通过统一接口为用户提供 Pokémon 信息。该服务连接 PokeAPI 获取 Pokémon 数据，并借助 MCP 工具为 Claude 桌面应用、Continue、Cline 等兼容客户端提供数据支持，让用户能更便捷地查询 Pokémon 相关信息。

🚀 快速开始

Poke - MCP 借助模型上下文协议（MCP），实现了 AI 应用程序与外部数据源的标准化交互。以下是其工作流程：

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

✨ 主要特性

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

📦 安装指南

使用 Smithery 快速安装

通过 [Smithery](https://smithery.ai/server/@NaveenBandarage/poke - mcp) 可自动为 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 桌面应用中使用

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

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

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

示例查询

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

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

项目结构

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

扩展新功能

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

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

🔧 技术细节

服务采用以下技术构建：

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

📄 许可证

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

Pokémon Data