poke-MCP服务器
项目介绍
【技术文档摘要】：
概述
Poke-MCP 是一个模型上下文协议（MCP）服务器，通过标准化接口提供宝可梦信息。它连接到 PokeAPI 获取宝可梦数据，并通过 MCP 工具将其暴露出来，这些工具可以被任何兼容 MCP 的客户端使用，如 Claude 桌面应用、Continue、Cline 等。
此服务器现在支持使用服务器发送事件（SSE）的 HTTP 传输进行实时通信，使其可以通过 HTTP 而不仅仅是标准 I/O 进行访问。
特性
- 通过名称获取特定宝可梦的信息
- 发现随机宝可梦
- 从特定地区（关东、城都、丰缘等）找到随机宝可梦
- 获取特定类型（火、水、电等）的随机宝可梦
- 自然语言查询接口以获取宝可梦信息
工作原理
Poke-MCP 使用 模型上下文协议 构建，该协议使 AI 应用能够以标准化方式访问外部工具和数据源。服务器：
- 连接到 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 进行输入验证
- 使用服务器发送事件（SSE）的 HTTP 传输进行 MCP 通信
- Node.js 内置 HTTP 服务器
安装
通过 Smithery 安装
要通过 Smithery 自动安装 Pokémcp 到 Claude 桌面应用：
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
使用方法
启动 HTTP 服务器
要在 HTTP 模式下启动服务器：
# 启动服务器（默认端口 3000）
npm start
# 或指定自定义端口
PORT=8080 npm start
服务器将在以下地址可用：
- 信息端点：
http://127.0.0.1:3000/- 服务器信息和状态 - SSE 端点：
http://127.0.0.1:3000/sse- 对 MCP 客户端的服务器发送事件连接 - 消息端点：
http://127.0.0.1:3000/message- 发送 MCP 消息的 POST 端点
与 Claude 桌面应用（HTTP 传输）一起使用
- 下载并安装 Claude 桌面应用
- 打开 Claude 桌面设置
- 前往开发者设置并编辑配置文件
- 添加以下配置用于 HTTP 传输：
{
"mcpServers": {
"pokedex": {
"transport": {
"type": "sse",
"url": "http://127.0.0.1:3000/sse"
}
}
}
}
- 启动 Poke-MCP 服务器：
npm start - 重启 Claude 桌面应用
- 现在你应该能在 Claude 中看到可用的宝可梦工具
遗留用法（标准 I/O）
为了向后兼容，你可以通过回退到标准 I/O 实现来运行服务器。
示例查询
一旦连接到 MCP 客户端，你可以提出如下问题：
- "告诉我关于皮卡丘的信息"
- "给我一个随机的宝可梦"
- "显示一个来自关东地区的随机宝可梦"
- "随机的水属性宝可梦是什么？"
项目结构
- src/index.ts：主服务器实现
- src/types.ts：宝可梦数据的 TypeScript 类型定义
- package.json：项目依赖和脚本
- tsconfig.json：TypeScript 配置
添加新功能
要添加新工具或增强现有工具：
- 定义新的辅助函数来获取和格式化数据
- 使用 server.tool() 方法注册新工具
- 实现工具逻辑以处理请求并返回响应
许可证
ISC
致谢
该项目展示了如何构建自定义 MCP 服务器，扩展 AI 助手的领域特定知识和能力。