概述

Poke-MCP 是一个模型上下文协议（MCP）服务器，通过标准化接口提供宝可梦信息。它连接到 PokeAPI 获取宝可梦数据，并通过MCP工具将其暴露出来，这些工具可以被任何兼容MCP的客户端使用，如Claude桌面应用程序、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桌面应用程序安装Pokémcp:

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

手动安装

bash

克隆仓库

git clone https://github.com/yourusername/poke-mcp.git
cd poke-mcp

安装依赖

npm install

构建项目

npm run build

使用

与Claude桌面应用程序一起使用

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

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

1. 重启Claude桌面应用程序
2. 现在你应该能在Claude中看到可用的宝可梦工具了

示例查询

一旦连接到MCP客户端，你可以提出如下问题：

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

项目结构

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

添加新功能

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

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

许可证

ISC

致谢

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

此项目展示了如何构建自定义MCP服务器，从而扩展AI助手的领域特定知识和能力。