金大哥 - pokemcp MCP 详情

article

README

🚀 Poke - MCP

Poke - MCP 是一个基于模型上下文协议（MCP）的服务器，借助标准化接口提供精灵宝可梦的相关信息。它连接到 PokeAPI 来获取精灵宝可梦的数据，再通过 MCP 工具向任何兼容的客户端（如 Claude Desktop App、Continue、Cline 等）提供信息，为用户带来便捷的精灵宝可梦信息查询体验。

🚀 快速开始

安装

使用 Smithery 安装

通过 Smithery 可自动为 Claude Desktop 安装 Poké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 Desktop App 一起使用

下载并安装 Claude Desktop App
打开 Claude Desktop 设置
进入开发者设置，编辑配置文件
添加以下配置：

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

重启 Claude Desktop
您现在应该可以在 Claude 中看到精灵宝可梦工具

示例查询

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

“告诉我关于皮卡丘”
“给我一个随机精灵宝可梦”
“显示一个来自卡托的随机精灵宝可梦”
“有什么随机的水属性精灵宝可梦？”

✨ 主要特性

通过名称获取特定精灵宝可梦的详细信息
发现随机精灵宝可梦
查找来自特定地区的随机精灵宝可梦（卡托、乔托、赫昂等）
获取特定类型的随机精灵宝可梦（火、水、电等）
支持自然语言查询接口，用于获取精灵宝可梦信息

🔧 技术细节

工作原理

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

连接到 PokeAPI 获取精灵宝可梦数据
通过 MCP 接口提供多个工具
处理来自 MCP 客户端的请求
返回格式化的精灵宝可梦信息

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 通信

📚 详细文档

项目结构

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

添加新功能

要添加新的工具或增强现有功能，可按以下步骤操作：

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

pokemcp