金大哥 - poke_api_mcp

article

README

🚀 基于 MCP 的 Pokémon 信息获取服务器

该项目是一个基于 mcp_rb 构建的 MCP 服务器，主要用于获取 Pokémon 信息。它借助 PokeAPI 拉取各类 Pokémon 数据，并为 Claude 提供了一个简洁的接口，方便其与 Pokémon 数据库进行交互。

🚀 快速开始

本项目旨在为你提供便捷的 Pokémon 信息获取服务，以下是快速开启服务的步骤：

首先安装所需的 gems：

bundle install

启动 MCP 服务器：

ruby poke_api.rb

✨ 主要特性

获取 Pokémon 的基本信息（ID、名称、身高、体重、类型）
获取 Pokémon 的精灵图像 URL
随机获取 Pokémon 的信息

📦 安装指南

安装依赖的 gems

在项目根目录下，执行以下命令安装所需的 gems：

bundle install

启动服务器

安装完成后，通过以下命令启动 MCP 服务器：

ruby poke_api.rb

💻 使用示例

基础用法

Claude 桌面配置

在你的 Claude 桌面配置文件中添加以下配置（通常位于 ~/.config/claude-desktop/config.json 或 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "local": {
      "command": "ruby",
      "args": ["/path/to/your/poke_api.rb"],
      "env": {
        "RUBY_ENV": "development"
      },
      "disabled": false,
      "alwaysAllow": ["pokemon_info", "pokemon_sprite"]
    }
  }
}

⚠️ 重要提示

请将 /path/to/your/poke_api.rb 替换为你实际的 poke_api.rb 文件路径。

可用工具

pokemon_info
- 获取 Pokémon 的基本信息
- 参数：name_or_id（Pokémon 名称或 ID）
pokemon_sprite
- 获取 Pokémon 精灵图像 URL
- 参数：name_or_id（Pokémon 名称或 ID）

代码示例

# 获取皮卡丘的信息
pokemon_info("pikachu")

# 获取皮卡丘的精灵图像 URL
pokemon_sprite("pikachu")

📚 详细文档

依赖项

本项目依赖以下组件：

Ruby
mcp gem
net/http
json
uri

📄 许可证

本项目采用 MIT License。

我们希望这份 README 能够帮助你有效地理解和使用该项目。

poke_api_mcp_rb