MCP 使用指南

SteamData Connect 支持 Model Context Protocol (MCP)，让 AI 应用能够直接访问 Steam 游戏数据。

什么是 MCP？

Model Context Protocol (MCP) 是一个开放协议，允许 AI 应用（如 Claude Desktop、Cline 等）通过标准化接口访问外部数据和工具。通过 MCP，AI 可以直接查询 Steam 游戏信息、评测数据、时序统计等，无需手动复制粘贴数据。

前置条件

• 一个 SteamData 账号
• 已创建团队并生成 API 密钥（参见快速开始）
• 支持 MCP 的 AI 客户端（如 Claude Desktop、Claude Code、GitHub Copilot、Cline 等）

配置 MCP 服务器

MCP 端点信息

• URL: https://endpoint.steamdata.ai/mcp
• 认证方式: Bearer Token
• API 密钥格式: Authorization: Bearer sdk_your_key_here

Claude Desktop 配置

在 Claude Desktop 的配置文件中添加：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "steamdata": {
      "url": "https://endpoint.steamdata.ai/mcp",
      "headers": {
        "Authorization": "Bearer sdk_your_api_key_here"
      }
    }
  }
}

Cline (VS Code 扩展) 配置

在 VS Code 的 Cline 设置中添加 MCP 服务器：

{
  "mcp.servers": [
    {
      "name": "SteamData",
      "url": "https://endpoint.steamdata.ai/mcp",
      "headers": {
        "Authorization": "Bearer sdk_your_api_key_here"
      }
    }
  ]
}

Claude Code (VS Code 扩展) 配置

使用 Claude Code CLI 添加 MCP 服务器：

claude mcp add --transport http steamdata https://endpoint.steamdata.ai/mcp \
  --header "Authorization: Bearer sdk_your_api_key_here"

管理服务器：

# 查看所有配置的服务器
claude mcp list

# 查看特定服务器详情
claude mcp get steamdata

# 移除服务器
claude mcp remove steamdata

详细配置说明请参考 Claude Code 官方文档。

GitHub Copilot 配置

在 VS Code 或其他支持 GitHub Copilot 的编辑器中配置：

设置路径: Settings → Extensions → GitHub Copilot → MCP Integration

{
  "github.copilot.advanced": {
    "mcpServers": {
      "steamdata": {
        "url": "https://endpoint.steamdata.ai/mcp",
        "headers": {
          "Authorization": "Bearer sdk_your_api_key_here"
        }
      }
    }
  }
}

语言参数规范

所有 MCP 工具中涉及语言参数的接口都支持多种格式（标准名称、BCP 47 码、Steam API 码）。

详细的语言参数格式和完整映射表请参见 语言参数规范。

可用工具

SteamData Connect 提供以下 MCP 工具：

1. steam_get_game

获取游戏的详细信息，包括基本信息、定价、评测统计、关注者数量等。

参数：

• appid (必需): Steam App ID

示例：

请帮我查看 Call of Duty: Black Ops 6 (App ID: 1938090) 的详细信息

2. steam_get_game_localized

获取游戏的本地化名称和描述。

参数：

• appid (必需): Steam App ID
• language (可选): 语言参数，支持标准名称、BCP 47 码或 Steam API 码（参见上方语言映射表）

示例：

请获取 Dota 2 (App ID: 570) 的中文简体名称和描述

3. steam_batch_games

批量获取多个游戏的基本信息（最多 100 个）。

参数：

• appids (必需): App ID 数组

示例：

请帮我对比这三款游戏的基本信息：570, 730, 1938090

4. steam_search_games

按名称搜索游戏，支持多语言搜索。

参数：

• query (必需): 搜索关键词
• language (可选): 搜索语言（参见上方语言映射表）
• limit (可选): 结果数量限制 (1-100，默认 20)

示例：

搜索所有名称包含 "Call of Duty" 的游戏

5. steam_filter_games

使用灵活的筛选条件获取游戏列表，支持分页和排序。

参数：

• filter: 筛选条件对象
  • app_type: 应用类型 (game, dlc, demo 等)
  • is_released: 是否已发布
  • is_free: 是否免费
  • developer: 开发商名称
  • publisher: 发行商名称
  • release_date: 发布日期范围
  • price: 价格范围
  • review_score: 评分范围
  • 等更多筛选选项...
• page: 页码 (从 0 开始)
• page_size: 每页数量 (1-100)

示例：

帮我找出 2024 年发布的、评分在 80 分以上的动作游戏，按发布日期排序

6. steam_get_timeseries

获取游戏的历史时序数据，包括评测、销量、收入、玩家数等。

参数：

• appid (必需): Steam App ID
• start_date (必需): 开始日期 (YYYY-MM-DD)
• end_date (必需): 结束日期 (YYYY-MM-DD)
• metrics (可选): 指标列表 (review, sales, revenue, price, follower, wishlist, ccu)

注意： 销量和收入数据需要特殊权限。

示例：

获取 Dota 2 在 2024 年 1 月的评测和玩家数据

7. steam_get_reviews

获取游戏的用户评测列表，支持灵活的筛选和排序。

参数：

• appid (必需): Steam App ID
• language (可选): 评测语言（参见上方语言映射表）
• voted_up (可选): 是否为好评 (true/false)
• steam_purchase (可选): 是否为购买用户的评测
• date_from (可选): 起始日期 (YYYY-MM-DD)
• date_to (可选): 结束日期 (YYYY-MM-DD)
• order_by (可选): 排序字段 (timestamp_created, rid)
• order_dir (可选): 排序方向 (ASC, DESC)
• offset (可选): 分页偏移量
• limit (可选): 结果数量 (1-100，默认 20)

示例：

获取 Black Myth: Wukong 最近的 50 条英文好评

8. steam_get_review

根据评测 ID 获取特定评测的详细信息。

参数：

• rid (必需): 评测 ID

示例：

查看评测 ID 12345678 的详细内容

使用示例

示例 1：游戏市场分析

提示词：分析一下 2024 年发布的前 10 款热门游戏的特点，
包括它们的类型、价格区间和用户评价趋势

AI 会自动：

1. 使用 steam_filter_games 筛选 2024 年发布的游戏
2. 使用 steam_get_game 获取每款游戏的详细信息
3. 使用 steam_get_reviews 分析用户评价
4. 生成综合分析报告

示例 2：竞品对比

提示词：对比 CS:GO (730) 和 Valorant (1517290) 
这两款 FPS 游戏的玩家评价和热度变化

AI 会自动：

1. 使用 steam_batch_games 获取两款游戏的基本信息
2. 使用 steam_get_reviews 分析各自的用户评价
3. 使用 steam_get_timeseries 获取历史数据
4. 生成对比分析

示例 3：本地化内容查询

提示词：查看 Elden Ring (1245620) 的中文简体介绍，
并分析中国玩家的评价情况

AI 会自动：

1. 使用 steam_get_game_localized 获取中文内容
2. 使用 steam_get_reviews 筛选中文评测
3. 分析评价趋势和常见反馈

配额与限制

MCP 调用与 REST API 共享配额：

• 免费套餐：每月 10,000 次请求
• 标准套餐：每月 100,000 次请求
• 企业套餐：自定义配额

每个 MCP 工具调用计为一次 API 请求。您可以在 Dashboard 查看实时配额使用情况。

错误处理

MCP 协议使用 JSON-RPC 2.0 标准错误格式：

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Game not found",
    "data": {
      "appid": 999999
    }
  },
  "id": 1
}

常见错误代码：

错误代码	说明
-32700	解析错误（无效的 JSON）
-32600	无效请求
-32601	方法不存在
-32602	无效参数
-32603	内部错误
-32001	数据不可用（如游戏不存在）
-32002	权限不足
-32003	配额已用尽

最佳实践

1. 批量查询：需要查询多个游戏时，优先使用 steam_batch_games 而不是多次调用 steam_get_game

2. 筛选优化：使用 steam_filter_games 的精确筛选条件，减少不必要的数据传输

3. 缓存结果：游戏的基本信息（如名称、发行商）变化较少，可以在应用中缓存

4. 日期范围：查询时序数据时，合理设置日期范围，避免请求过多数据

5. 分页处理：处理大量结果时使用分页参数，避免单次请求过载

开发调试

测试 MCP 连接

使用 cURL 测试 MCP 端点：

curl -X POST https://endpoint.steamdata.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sdk_your_key_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

测试工具调用

curl -X POST https://endpoint.steamdata.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sdk_your_key_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "steam_get_game",
      "arguments": {
        "appid": 570
      }
    }
  }'

获取帮助

• MCP 官方文档
• API 参考文档
• REST API 快速开始
• 技术支持：[email protected]

---

通过 MCP，您可以轻松构建智能化的游戏数据分析应用！🚀