Steam MCP

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

本項目藉助Node.js、TypeScript和@modelcontextprotocol/sdk搭建了一個蒸汽MCP（模型上下文協議）服務器。該服務器充當橋樑，連接MCP客戶端（如Roo）和蒸汽網頁API，為各類蒸汽遊戲統計信息和用戶數據提供結構化訪問途徑。

✨ 主要特性

• 作為中介，連接MCP客戶端與蒸汽網頁API，提供結構化數據訪問。
• 通過標準輸入輸出（stdio）與MCP客戶端通信，使用@modelcontextprotocol/sdk的StdioServerTransport。
• 監聽tools/call請求，驗證請求，調用蒸汽網頁API並返回格式化結果或錯誤信息。

📦 安裝指南

先決條件

• Node.js（推薦v18或更高版本）。
• npm（通常隨Node.js一起提供）。

克隆倉庫

git clone <repository-url> # 替換為你的倉庫URL
cd steam-mcp

安裝依賴項

npm install

配置環境變量

服務器需要設置STEAM_API_KEY環境變量，可在蒸汽開發者網站獲取。在項目根目錄創建.env文件，並添加以下內容：

STEAM_API_KEY=你的API密鑰

⚠️ 重要提示：請確保.env文件不在版本控制系統中（例如，在.gitignore中排除）。

構建項目

npm run build

此命令將TypeScript代碼編譯到build目錄中。

💻 使用示例

運行服務器

構建項目後，運行以下命令啟動服務器：

node build/index.js

可用的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": "." // 當前工作目錄，這裡是項目根目錄
    }
  ]
}

配置完成後，保存文件並重啟MCP客戶端。現在你可以通過該連接與服務器通信了！

🔧 技術細節

技術棧

• 語言：TypeScript
• 運行時：Node.js（推薦v18+）
• HTTP客戶端：Axios
• 環境變量：Dotenv
• MCP SDK：@modelcontextprotocol/sdk
• 包管理：npm

服務器通過標準輸入輸出（stdio）與MCP客戶端通信，使用@modelcontextprotocol/sdk的StdioServerTransport。它監聽tools/call請求、驗證請求、使用Axios調用蒸汽網頁API，並返回格式化結果或適當的錯誤信息。