AI导哈

游戏数据库MCP服务器

一个快速可靠的MCP服务器，通过Claude Desktop提供对RAWG详细游戏数据库的访问，支持游戏搜索、详细信息获取、类型探索和热门游戏发现。

  • by BaranDev
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 BaranDev/videogames-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工具、错误处理和数据分析✅ 所有步骤均已通过

📊 测试结果总结

测试类别 测试用例 状态 屏幕截图
基本搜索 搜索“塞尔达”游戏（前5名） ✅ 通过 1.png
热门游戏 获取十大最受欢迎游戏✅ 通过 2.png
错误处理 搜索“不存在流派” ✅ 善意的错误 3.png
多人游戏查询 查找流行的多人游戏 ✅ 复杂的工作流程 4.png
综合套房 完整的7步测试序列 ✅ 所有步骤均已通过 5.png, 5-1.png

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

安装

先决条件

  • 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许可证-请参阅 许可证 文件以获取详细信息。

相关 MCP