星战科技xingzhan.cloud
返回市场
宝可梦Go-MCP服务器

宝可梦Go-MCP服务器

作者：GhostTypes2 星标更新：2025-11-24
安装使用来源：spider==github.com

项目介绍

<div align="center"> <h1>Pokemon Go MCP 服务器</h1> <p>一个全面的模型上下文协议（MCP）服务器，提供实时的《宝可梦Go》数据，包括活动、突袭、研究任务、蛋孵化以及火箭队阵容。</p> </div> <p align="center"> <img src="https://img.shields.io/badge/Python-3.10+-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+"> <img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="MIT 许可证"> <img src="https://img.shields.io/badge/平台-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey?style=for-the-badge" alt="平台支持"> </p>
<div align="center"> <h2>功能概述</h2> </div> <div align="center"> <table> <tr> <th>类别</th> <th>功能</th> <th>关键能力</th> </tr> <tr> <td><strong>活动</strong></td> <td>当前活动、活动详情、社区日</td> <td>实时活动跟踪、出现数据、奖励、专属招式</td> </tr> <tr> <td><strong>突袭</strong></td> <td>突袭首领、等级筛选、闪亮追踪</td> <td>完整的突袭列表、类型筛选、天气增益检测</td> </tr> <tr> <td><strong>研究</strong></td> <td>实地任务、奖励追踪、任务筛选</td> <td>任务发现、闪亮奖励、轻松完成路径</td> </tr> <tr> <td><strong>蛋</strong></td> <td>蛋池、距离筛选、闪亮追踪</td> <td>基于距离的筛选、地区独占、冒险同步奖励</td> </tr> <tr> <td><strong>火箭队</strong></td> <td>阵容、影子宝可梦、遭遇奖励</td> <td>完整的训练师阵容、类型效果、闪亮影子</td> </tr> <tr> <td><strong>跨平台</strong></td> <td>通用搜索、每日优先事项、状态</td> <td>多源搜索、精选推荐、缓存管理</td> </tr> </table> </div>
<div align="center"> <h2>快速开始</h2> </div> <div align="center"> <table> <tr> <th>步骤</th> <th>命令</th> <th>描述</th> </tr> <tr> <td><strong>1. 克隆</strong></td> <td><code>git clone &lt;repository-url&gt;</code></td> <td>克隆仓库</td> </tr> <tr> <td><strong>2. 进入目录</strong></td> <td><code>cd pokemon-go-mcp</code></td> <td>进入项目目录</td> </tr> <tr> <td><strong>3. 安装 (uv)</strong></td> <td><code>uv sync</code></td> <td>使用 uv 包管理器安装（推荐）</td> </tr> <tr> <td><strong>3. 安装 (pip)</strong></td> <td><code>pip install -e .</code></td> <td>使用 pip 安装</td> </tr> <tr> <td><strong>4. 运行</strong></td> <td><code>uv run python server.py</code></td> <td>启动 MCP 服务器</td> </tr> </table> </div>

前提条件

  • Python 3.10 或更高版本
  • uv 包管理器（推荐）或 pip
<div align="center"> <h2>集成选项</h2> </div> <div align="center"> <table> <tr> <th>平台</th> <th>配置</th> <th>备注</th> </tr> <tr> <td><strong>Claude Desktop</strong></td> <td>添加到 <code>claude_desktop_config.json</code></td> <td>需要绝对路径到 server.py</td> </tr> <tr> <td><strong>Claude Code</strong></td> <td>使用 <code>claude mcp add</code> 命令</td> <td>或者手动创建 <code>.mcp.json</code></td> </tr> <tr> <td><strong>VS Code</strong></td> <td>创建 <code>.vscode/mcp.json</code></td> <td>支持 stdio 和 HTTP 传输</td> </tr> <tr> <td><strong>n8n 工作流</strong></td> <td>安装 <code>n8n-nodes-mcp</code></td> <td>推荐使用 HTTP 传输</td> </tr> <tr> <td><strong>Docker</strong></td> <td>使用 <code>docker build</code> 和 <code>docker run</code></td> <td>支持 HTTP/SSE 传输</td> </tr> </table> </div>

Claude Desktop 配置

{
  "mcpServers": {
    "pokemon-go": {
      "command": "uv",
      "args": ["run", "python", "/path/to/pokemon-go-mcp/pogo_mcp/server.py"]
    }
  }
}

Claude Code 配置

# 使用 claude mcp 命令快速添加
claude mcp add pokemon-go uv run python /path/to/pokemon-go-m
cp/pogo_mcp/server.py

# 或者在项目目录中手动创建 .mcp.json
echo '{"servers": {"pokemon-go": {"command": "uv", "args": ["run", "python", "/path/to/pokemon-go-mcp/pogo_mcp/server.py"]}}}' > .mcp.json

VS Code 配置

在工作区创建 .vscode/mcp.json：

{
  "servers": {
    "pokemon-go-stdio": {
      "command": "uv",
      "args": ["run", "python", "/path/to/pokemon-go-mcp/pogo_mcp/server.py"]
    },
    "pokemon-go-http": {
      "type": "http",
      "url": "http://localhost:8000",
      "description": "通过 HTTP 的 Pokemon Go MCP 服务器"
    }
  }
}

n8n 工作流

  1. 安装 n8n MCP 节点：

    npm install n8n-nodes-mcp
# 设置环境变量：N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

  2. 配置 MCP 客户端节点：

    • 连接类型：HTTP 流式传输（推荐）
    • URL：http://localhost:8000（当使用 MCP_TRANSPORT=http 运行时）
    • 头部信息：如有需要，可添加身份验证头部信息

  3. n8n 的 Docker 部署：

    # 构建并运行 Pokemon Go MCP 服务器
docker build -t pokemon-go-mcp .
docker run -d -p 8000:8000 -e MCP_TRANSPORT=http pokemon-go-mcp

传输模式

<div align="center"> <table> <tr> <th>传输</th> <th>命令</th> <th>用例</th> </tr> <tr> <td><strong>HTTP</strong></td> <td><code>MCP_TRANSPORT=http MCP_PORT=8000 python pogo_mcp/server.py</code></td> <td>Web 集成、自动化工具</td> </tr> <tr> <td><strong>SSE</strong></td> <td><code>MCP_TRANSPORT=sse MCP_PORT=8000 python pogo_mcp/server.py</code></td> <td>旧系统</td> </tr> <tr> <td><strong>stdio</strong></td> <td><code>python pogo_mcp/server.py</code></td> <td>默认，Claude Desktop</td> </tr> </table> </div>
<div align="center"> <h2>展示</h2> </div> <div align="center">

Pokemon Go MCP 服务器展示 1

Pokemon Go MCP 服务器展示 2

Pokemon Go MCP 服务器展示 3

</div>
<div align="center"> <h2>可用工具</h2> </div> <div align="center"> <table> <tr> <th>工具名称</th> <th>类别</th> <th>描述</th> </tr> <tr> <td><code>get_current_events</code></td> <td>活动</td> <td>列出所有正在进行和即将进行的活动</td> </tr> <tr> <td><code>get_event_details</code></td> <td>活动</td> <td>特定活动的详细信息</td> </tr> <tr> <td><code>get_community_day_info</code></td> <td>活动</td> <td>社区日的具体内容和特色宝可梦</td> </tr> <tr> <td><code>get_event_spawns</code></td> <td>活动</td> <td>活动期间出现频率更高的宝可梦</td> </tr> <tr> <td><code>get_event_bonuses</code></td> <td>活动</td> <td>正在进行的活动奖励（经验值、星尘等）</td> </tr> <tr> <td><code>search_events</code></td> <td>活动</td> <td>按名称或类型搜索活动</td> </tr> <tr> <td><code>get_current_raids</code></td> <td>突袭</td> <td>按等级划分的所有当前突袭首领</td> </tr> <tr> <td><code>get_raid_by_tier</code></td> <td>突袭</td> <td>按等级筛选突袭（1级、3级、5级、超巨）</td> </tr> <tr> <td><code>get_shiny_raids</code></td> <td>突袭</td> <td>仅限闪亮资格的突袭首领</td> </tr> <tr> <td><code>search_raid_boss</code></td> <td>突袭</td> <td>查找特定宝可梦在突袭中的位置</td> </tr> <tr> <td><code>get_raids_by_type</code></td> <td>突袭</td> <td>按宝可梦类型筛选突袭</td> </tr> <tr> <td><code>get_weather_boosted_raids</code></td> <td>突袭</td> <td>受天气影响的突袭</td> </tr> <tr> <td><code>get_raid_recommendations</code></td> <td>突袭</td> <td>基于优先事项的智能突袭推荐</td> </tr> <tr> <td><code>get_current_research</code></td> <td>研究</td> <td>所有实地研究任务及其奖励</td> </tr> <tr> <td><code>search_research_by_reward</code></td> <td>研究</td> <td>按宝可梦奖励查找任务</td> </tr> <tr> <td><code>get_research_by_task_type</code></td> <td>研究</td> <td>按任务类型筛选（捕捉、战斗、旋转等）</td> </tr> <tr> <td><code>get_shiny_research_rewards</code></td> <td>研究</td> <td>具有闪亮奖励潜力的任务</td> </tr> <tr> <td><code>get_easy_research_tasks</code></td> <td>研究</td> <td>快速完成的任务以高效耕种</td> </tr> <tr> <td><code>search_research_tasks</code></td> <td>研究</td> <td>按描述搜索任务</td> </tr> <tr> <td><code>get_research_recommendations</code></td> <td>研究</td> <td>个性化研究任务推荐</td> </tr> <tr> <td><code>get_egg_hatches</code></td> <td>蛋</td> <td>当前从蛋中孵化的所有宝可梦</td> </tr> <tr> <td><code>get_egg_hatches_by_distance</code></td> <td>蛋</td> <td>按蛋的距离筛选（2公里、5公里、10公里等）</td> </tr> <tr> <td><code>get_shiny_egg_hatches</code></td> <td>蛋</td> <td>具有闪亮资格的蛋宝可梦</td> </tr> <tr> <td><code>search_egg_pokemon</code></td> <td>蛋</td> <td>查找特定宝可梦在蛋池中的位置</td> </tr> <tr> <td><code>get_regional_egg_pokemon</code></td> <td>蛋</td> <td>地区独占的蛋宝可梦</td> </tr> <tr> <td><code>get_gift_exchange_pokemon</code></td> <td>蛋</td> <td>来自朋友的7公里礼物蛋宝可梦</td> </tr> <tr> <td><code>get_route_gift_pokemon</code></td> <td>蛋</td> <td>7公里路线礼物蛋宝可梦</td> </tr> <tr> <td><code>get_adventure_sync_rewards</code></td> <td>蛋</td> <td>冒险同步每周步行奖励</td> </tr> <tr> <td><code>get_egg_recommendations</code></td> <td>蛋</td> <td>智能孵化策略推荐</td> </tr> <tr> <td><code>get_team_rocket_lineups</code></td> <td>火箭队</td> <td>当前所有火箭队训练师阵容</td> </tr> <tr> <td><code>search_rocket_by_pokemon</code></td> <td>火箭队</td> <td>查找使用特定宝可梦的训练师</td> </tr> <tr> <td><code>get_shiny_shadow_pokemon</code></td> <td>火箭队</td> <td>所有可以闪亮的影子宝可梦</td> </tr> <tr> <td><code>get_rocket_encounters</code></td> <td>火箭队</td> <td>作为遭遇奖励的宝可梦</td> </tr> <tr> <td><code>get_rocket_trainers_by_type</code></td> <td>火箭队</td> <td>按宝可梦类型专长筛选训练师</td> </tr> <tr> <td><code>calculate_pokemon_weakness</code></td> <td>火箭队</td> <td>对影子宝可梦的类型效果计算</td> </tr> <tr> <td><code>get_rocket_trainer_details</code></td> <td>火箭队</td> <td>特定训练师的详细信息</td> </tr> <tr> <td><code>get_all_shiny_pokemon</code></td> <td>跨平台</td> <td>所有来源的闪