Video Games MCP Server

视频游戏MCP服务器

一个快速、可靠的模型上下文协议（MCP）服务器，通过Claude Desktop提供对RAWG详细游戏数据库的访问。无需离开聊天界面，即可搜索游戏、获取详细信息、探索流派和发现热门游戏。

为什么使用这个？

你有没有发现自己打开多个浏览器标签只是为了研究一个游戏？这个MCP服务器通过将RAWG的整个游戏数据库直接引入Claude Desktop来消除这种麻烦。无论你是想记住《赛博朋克2077》是否终于值得一玩，还是想在你的直播中快速了解独立游戏，只要问克劳德，就能得到即时、全面的答案。

特性

• 智能游戏搜索：通过模糊匹配按标题查找实际有效的游戏
• 游戏详细信息：评级、平台、开发者、发布日期、描述等
• 类型探索：浏览完整的游戏类别，而不会掉进兔子洞
• 热门游戏发现：在不操纵算法的情况下查看趋势
• 无缝集成Claude：直接在Claude Desktop中工作-无需切换应用程序
• 快速可靠：内置FastMCP和异步操作以提高速度

测试结果（点击箭头查看截图）

Basic Search Test: "Can you search for games with 'zelda' in the title and show me the top 5 results?"

*测试：带有限制参数的search_game_by_title工具-✅ 通过*

Popular Games Test: "Show me the top 10 most popular games right now."

*测试：带有限制参数的get_popular_games工具-✅ 通过*

Error Handling Test: "Look for popular games in a genre called 'NonExistentGenre'."

*测试：无效流派名称的错误处理-✅ 善意的错误*

Multiplayer Games Test: "I'm planning a gaming night with friends. Can you recommend 2 popular multiplayer games?"

*测试：结合搜索和分析的复杂工作流程-✅ 复杂工作流*

Comprehensive Test Suite: Full 7-step MCP server validation

Part 1: Steps 1-4

Part 2: Steps 5-7

*测试：所有四个MCP工具、错误处理和数据分析✅ 所有步骤均已通过*

📊 测试结果总结

*所有测试都会返回格式正确的游戏数据，包括标题、评级、平台和元数据。*

安装

先决条件

• Python 3.11或更高版本
• RAWGneneneba API密钥（免费 原料.io/apidocs)
• Claude桌面应用程序

快速设置

1.克隆和导航

git clone https://github.com/barandev/videogames-mcp-server.git
cd videogames-mcp-server

2.创建虚拟环境

# With UV (recommended - faster)
uv venv
source .venv/bin/activate          # macOS/Linux
.\.venv\Scripts\Activate.ps1       # Windows PowerShell

# Or with standard Python
python -m venv .venv
# Then activate as above

3.安装依赖项

pip install -r requirements.txt

4.配置API访问

# Copy environment template
cp .env.example .env
# Edit .env and add your RAWG API key

💡 在获取免费API密钥 原料.io/apidocs -这是服务器运行所必需的。

5.验证安装

python main.py

Claude桌面配置

Windows配置：

将此添加到您的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "videogames": {
      "command": "C:\\path\\to\\videogames-mcp-server\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\videogames-mcp-server\\main.py"],
      "cwd": "C:\\path\\to\\videogames-mcp-server",
      "env": {
        "RAWG_API_KEY": "your_api_key_here"
      }
    }
  }
}

macOS/Linux配置：

{
  "mcpServers": {
    "videogames": {
      "command": "/path/to/videogames-mcp-server/.venv/bin/python",
      "args": ["/path/to/videogames-mcp-server/main.py"],
      "cwd": "/path/to/videogames-mcp-server",
      "env": {
        "RAWG_API_KEY": "your_api_key_here"
      }
    }
  }
}

注： 使用绝对路径并在更改后重新启动Claude Desktop。

可用工具

search_game_by_title

通过模糊匹配按标题搜索游戏。

• 参数：游戏标题，可选结果限制
• 退货：带有评级、平台和屏幕截图的匹配游戏列表

get_game_details

获取有关特定游戏的全面信息。

• 参数：游戏ID（来自搜索结果）
• 退货：描述、开发者、出版商、发布日期、评级、平台、ESRB信息

list_genres

列出所有可用的游戏类型。

• 参数：无
• 退货：完整的游戏类型列表

get_popular_games

发现热门和高评价的游戏。

• 参数：可选限制，可选类型过滤器
• 退货：包含元数据的热门游戏列表

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。