Poke-MCP

概述

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

特征

通过名称获取特定神奇宝贝的信息
发现随机宝可梦
寻找来自特定地区（关都、城都、丰缘等）的随机神奇宝贝
获取特定类型的随机神奇宝贝（火、水、电等）
神奇宝贝信息的自然语言查询界面

工作原理

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

连接到 PokeAPI 以获取 Pokémon 数据
通过 MCP 界面公开多种工具
处理来自 MCP 客户端的请求
返回格式化的神奇宝贝信息

MCP 工具

该服务器提供以下工具：

get-pokemon：通过名称获取特定神奇宝贝的详细信息
random-pokemon：获取有关随机神奇宝贝的信息
random-pokemon-from-region：从特定区域随机获取一只神奇宝贝
random-pokemon-by-type：获取特定类型的随机神奇宝贝
pokemon-query：回答有关 Pokémon 的自然语言查询

建筑学

该服务器使用以下方式构建：

TypeScript
MCP TypeScript SDK（@modelcontextprotocol/sdk）
Zod 用于输入验证
MCP 通信的标准 I/O 传输

安装

通过 Smithery 安装

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

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

手动安装

# Clone the repository
git clone https://github.com/yourusername/poke-mcp.git
cd poke-mcp

# Install dependencies
npm install

# Build the project
npm run build

用法

使用 Claude 桌面应用程序

下载并安装Claude 桌面应用程序
打开 Claude 桌面设置
转到开发者设置并编辑配置文件
添加以下配置：

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

重启Claude桌面
你现在应该可以看到 Claude 中可用的 Pokémon 工具

示例查询

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

“跟我讲讲皮卡丘吧”
“给我一只随机的宝可梦”
“随机给我看看一只来自关东地区的宝可梦”
“随机水系宝可梦是什么？”

项目结构

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

添加新功能

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

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

执照

国际学习中心

致谢

PokeAPI用于提供 Pokémon 数据
标准化接口的模型上下文协议

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

概述

特征