蒸汽MCP服务器（Node.js/TypeScript）

概述

此项目使用Node.js、TypeScript以及@modelcontextprotocol/sdk实现了一个蒸汽MCP（模型上下文协议）服务器。该服务器作为中介，连接一个MCP客户端（如Roo）和蒸汽网页API，提供对各种蒸汽游戏统计信息和用户数据的结构化访问。

它通过标准输入输出(stdio)与MCP客户端通信，使用@modelcontextprotocol/sdk的StdioServerTransport。它监听tools/call请求、验证请求、使用Axios调用蒸汽网页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（必需）: 你的蒸汽网页API密钥。在蒸汽开发者网站获取一个密钥。没有此密钥，服务器无法运行。

该项目使用项目根目录中的.env文件加载API密钥。创建名为.env的文件，并添加以下内容：

STEAM_API_KEY=你的API密钥

• 注意: 请确保.env文件不在版本控制系统中（例如，在.gitignore中排除）。

运行服务器

构建项目后，运行以下命令启动服务器：

node build/index.js

可用的MCP命令

以下是当前实现的MCP命令列表：

isql:runQuery

执行SQL查询并返回结果。使用以下参数：

ping:ping

测试服务器是否存活。

连接本地MCP客户端（例如Roo）

要配置MCP客户端连接此服务器，请按照以下步骤操作：

1. 打开MCP客户端的配置文件（通常位于~/.mcp/settings.json）。
2. 添加新的连接配置，如下所示：

{
  "connections": [
    {
      "name": "steam", // 连接名称
      "type": "stdio", // 必须是"stdio"
      "enabled": true, // 设置为true以启用连接
      "command": "node", // 执行Node.js运行时的命令
      "args": ["build/index.js"], // 传递给命令的参数，这里指定编译后的服务器脚本路径
      "cwd": "." // 当前工作目录，这里是项目根目录
    }
  ]
}

• name: 这个连接的唯一标识符（例如steam）。
• type: 必须是stdio。
• enabled: 设置为true以激活该连接。
• command: 执行Node.js运行时的命令（如node）。
• args: 传递给命令的参数，这里应指定编译后的服务器脚本路径（如build/index.js）。
• cwd: 运行服务器的工作目录（项目根目录）。

配置完成后，保存文件并重启MCP客户端。现在你可以通过该连接与服务器通信了！