Steam MCP 服务器 (Node.js/TypeScript)

概述

本项目使用 Node.js、TypeScript 和 @modelcontextprotocol/sdk 实现了一个 Steam MCP (模型上下文协议) 服务器。该服务器充当 MCP 客户端（如 Roo）和 Steam Web API 之间的中介，提供对各种 Steam 游戏统计数据和用户信息进行结构化访问。

它通过标准输入/输出 (stdio) 使用 @modelcontextprotocol/sdk 的 StdioServerTransport 与 MCP 客户端通信。 它监听 tools/call 请求，验证它们，使用 Axios 与 Steam Web API 交互，并返回格式化的结果或适当的错误消息。

技术栈

• 语言: TypeScript
• 运行时: Node.js (建议 v18+)
• HTTP 客户端: Axios
• 环境变量: Dotenv
• MCP SDK: @modelcontextprotocol/sdk
• 包管理: npm

设置和安装

1. 先决条件:

   • Node.js (建议 v18 或更高版本)。
   • npm (通常包含在 Node.js 中)。

2. 克隆存储库 (如果尚未克隆):

   git clone <repository-url> # 替换为您的存储库 URL
   cd steam-mcp
   

3. 安装依赖项:

   npm install
   

4. 配置环境变量: 请参阅下面的部分。

5. 构建项目:

   npm run build
   

   这会将 TypeScript 代码编译到 build 目录中。

配置 (环境变量)

服务器需要设置以下环境变量：

• STEAM_API_KEY (必需): 您的 Steam Web API 密钥。 从 Steam 开发者网站 获取一个。 如果没有此密钥，服务器将无法运行。

本项目使用项目根目录中的 .env 文件来加载 API 密钥。 在 steam-mcp 目录中创建一个名为 .env 的文件，并添加以下行：

STEAM_API_KEY=YOUR_API_KEY_HERE

将 YOUR_API_KEY_HERE 替换为您的实际 Steam Web API 密钥。

运行服务器 (独立)

构建项目 (npm run build) 并配置 .env 文件后，您可以直接使用 Node 运行服务器：

node build/index.js

服务器将启动并监听标准输入/输出上的 MCP 消息。

可用的 MCP 命令

此服务器基于 Steam Web API 提供以下工具：

• getCurrentPlayers: 检索给定 AppID 的当前玩家数量。
• getAppList: 检索 Steam 上所有公共应用程序的完整列表。
• getGameSchema: 检索给定 AppID 的游戏架构（统计信息、成就）。
• getAppDetails: 检索一个或多个 AppID 的商店页面详细信息。
• getGameNews: 检索给定 AppID 的最新新闻项目。
• getPlayerAchievements: 检索特定游戏中玩家的成就状态。
• getUserStatsForGame: 检索特定游戏中用户的详细统计信息。
• getGlobalStatsForGame: 检索特定游戏的聚合全局统计信息。
• getSupportedApiList: 检索支持的 Steam Web API 接口和方法的列表。
• getGlobalAchievementPercentages: 检索游戏的全局成就完成百分比。

连接本地 MCP 客户端 (例如，Roo)

要将本地 MCP 客户端（例如 Roo VS Code 扩展）连接到此服务器，您需要配置客户端的 mcp.json 文件。 此文件通常位于项目或用户设置中的 .roo 目录中。

该配置告诉客户端如何使用标准输入/输出启动服务器并与之通信。

1. 确保项目已构建: 运行 npm run build。
2. 找到或创建您的 mcp.json 文件: 这可能位于您的工作区中的 .roo/mcp.json 或全局配置位置。
3. 添加服务器配置: 将条目添加到 mcp.json 中的 servers 数组。

mcp.json 条目示例:

{
  "servers": [
    // ... 其他服务器配置 ...
    {
      "name": "steam-local-stdio", // 选择一个描述性名称
      "type": "stdio",
      "enabled": true,
      "command": "node", // 要执行的命令
      "args": [
        // 构建的 index.js 文件的绝对路径
        "C:\\Users\\<username>\\AppData\\Roaming\\Roo-Code\\MCP\\steam-mcp\\build\\index.js"
        // 如果您的项目位置不同，请调整路径
      ],
      "cwd": "C:\\Users\\<username>\\AppData\\Roaming\\Roo-Code\\MCP\\steam-mcp" // 工作目录（项目根目录）
    }
  ]
}

• name: 此服务器连接的唯一标识符（例如，steam）。
• type: 必须是 stdio。
• enabled: 设置为 true 以激活连接。
• command: 运行 Node.js 运行时的命令 (node)。
• args: 包含已编译服务器脚本 (build/index.js) 的绝对路径的数组。 重要提示: 确保此路径对您的系统正确。 在 Windows 上的 JSON 字符串中使用双反斜杠 (\\) 作为路径。
• cwd: 项目根目录的绝对路径，服务器应从中运行。 重要提示: 确保此路径对您的系统正确。

配置并启用后，您的 MCP 客户端应该能够通过 stdio 启动此服务器并与之通信。