MCP VIDEOGAMES REC INFO

RAWG游戏MCP服务器

一种模型上下文协议（MCP）服务器，使用RAWG-视频游戏数据库API提供游戏信息和推荐。

特性

• 游戏搜索：按名称查找带有详细信息的游戏
• 热门游戏：获取当前热门游戏列表
• 类型筛选：按特定类型（动作、RPG、策略等）浏览游戏
• 平台过滤：查找特定平台上可用的游戏
• 游戏详细信息：获取任何游戏的全面详细信息，包括开发者、发行商、评级和描述
• 热门游戏：了解当前游戏的趋势
• 智能日志记录：记录所有交互以进行调试和分析

安装说明

1.安装依赖项

确保您已安装Python 3.8+，然后安装所需的软件包：

pip install -r requirements.txt

2.获取原始API密钥

1. 访问 https://rawg.io/apidocs
2. 点击“获取API密钥”
3. 创建一个免费帐户（如果您没有）
4. 登录后，您将在仪表板中看到您的API密钥
5. 复制您的API密钥（看起来像： 1234567890abcdef1234567890abcdef12345678)

3.创建环境文件

创建一个 .env 文件与服务器脚本位于同一目录中：

# .env file
RAWG_API_KEY=your_actual_api_key_here

替换 your_actual_api_key_here 使用从RAWG复制的API密钥。

4.测试服务器

运行服务器以确保一切正常：

python mcp_server.py

如果成功，您应该看到服务器启动时没有错误。

可用工具

search_games(query, page_size=5)

按名称搜索游戏。

• query：要搜索的游戏名称
• page_size：结果数（1-20，默认值5）

示例：搜索“巫师”游戏

get_popular_games(page_size=10)

获取热门游戏列表。

• page_size：要返回的游戏数（1-20，默认10）

get_games_by_genre(genre, page_size=10)

查找特定类型的游戏。

• genre：流派名称（动作、角色扮演、策略、冒险、射击等）
• page_size：要返回的游戏数（1-20，默认10）

示例：获取顶级RPG游戏

get_games_by_platform(platform, page_size=10)

查找特定平台的游戏。

• platform：平台名称（pc、playstation-5、xbox系列-x、任天堂交换机等）
• page_size：要返回的游戏数（1-20，默认10）

示例：获取Nintendo Switch游戏

get_game_details(game_name)

获取特定游戏的详细信息。

• game_name：确切或部分游戏名称

示例：获取《赛博朋克2077》的详细信息

get_trending_games(page_size=10)

获取当前热门游戏。

• page_size：要返回的游戏数（1-20，默认10）

使用示例

使用MCP客户端

# Search for games
search_games("minecraft")

# Get popular RPG games
get_games_by_genre("rpg", 5)

# Get detailed info about a specific game
get_game_details("The Legend of Zelda: Breath of the Wild")

# Find games for PlayStation 5
get_games_by_platform("playstation-5", 8)

文件结构

rawg-gaming-server/
├── mcp_server.py          # Main server file
├── requirements.txt       # Python dependencies
├── .env                  # API key configuration (create this)
├── README.md             # This file
└── logs/
    └── rawg_mcp_log.json # Interaction logs (auto-created)

速率限制

服务器执行基本速率限制，以尊重RAWGneneneba API：

• 每秒最多1个请求
• 失败请求的自动重试处理
• 超时处理（每个请求超时10秒）

日志记录

所有交互都记录到 logs/rawg_mcp_log.json 包括：

• 用户请求
• API响应
• 错误消息
• 时间戳

这有助于调试和理解使用模式。

常见问题

“未配置RAWG_API_KEY”错误

• 确保你的 .env 文件存在于正确的目录中
• 验证API密钥是否正确且处于活动状态
• 检查一下 .env 文件的键周围没有多余的空格或引号

“超出速率限制”错误

• 免费的RAWGneneneba API有价格限制
• 服务器包括内置的速率限制，以防止这种情况
• 如果你达到了限制，请等待几分钟再提出更多请求

未找到游戏

• RAWG数据库可能没有每个游戏
• 尝试不同的搜索词或部分名称
• 一些非常新或非常旧的游戏可能不会被索引

API学分

此服务器使用 RAWG-视频游戏数据库API.

• 免费等级：每月20000次请求
• 个人项目没有商业使用限制
• 赞赏但不要求署名

许可证

此MCP服务器按原样提供，用于教育和个人用途。请遵守RAWGneneneba API的服务条款和价格限制。

支持

有关此MCP服务器的问题，请检查：

1. 你的 .env 文件配置
2. Internet连接
3. 上的原始API状态 https://rawg.io

服务器记录所有交互以帮助调试-检查日志文件夹以获取详细的错误信息。