Pokémon Data

🚀 Poke - MCP

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

🚀 快速开始

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

1. 连接到 PokeAPI 获取 Pokémon 数据。
2. 通过 MCP 接口暴露多个工具。
3. 处理 MCP 客户端请求。
4. 返回格式化 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 桌面应用中使用

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. 实现具体的业务逻辑。

🔧 技术细节

服务采用以下技术构建：

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

📄 许可证

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