Steamstats MCP

🚀 蒸汽統計數據服務器文檔

本項目的蒸汽統計數據服務器，可助力開發者獲取與Valve Steam遊戲平臺相關聯的各種統計信息和數據，為Steam遊戲的數據統計與分析提供有力支持。

🚀 快速開始

環境要求

• Python版本：3.8及以上。
• 操作系統：Linux、macOS或Windows（推薦使用Linux進行生產環境部署）。

安裝步驟

1. 克隆此倉庫到本地開發環境中：

   git clone <repository-url>
   

2. 進入項目目錄：

   cd steamstats-server
   

3. 使用poetry安裝依賴：

   poetry install
   

4. 啟動服務器：

   poetry run uvicorn main:app --host $HOST --port $PORT --reload
   

服務器運行

1. 啟動服務器：

   uvicorn main:app --host $HOST --port $PORT --reload
   

2. 訪問文檔：默認情況下，FastAPI會在http://localhost:8000/docs提供交互式API文檔。

✨ 主要特性

• 獲取遊戲的當前在線玩家數量。
• 獲取特定遊戲的應用詳情。
• 獲取遊戲的數據架構。
• 獲取遊戲新聞。
• 獲取玩家成就。
• 獲取用戶的遊戲統計數據。
• 獲取遊戲的全球統計數據。
• 獲取支持的API列表。
• 獲取應用列表。
• 獲取遊戲的全球成就百分比。

🔧 技術細節

技術棧

以下是構建此服務器所使用的主要技術：

• 框架：FastAPI（用於快速開發高性能的Web服務）。
• 運行時：Python 3.8+。
• 依賴管理：poetry（用於包管理）。
• 日誌記錄：logging模塊（用於記錄服務器操作日誌）。

請求流程圖

以下是一個簡化的請求流程圖：

1. 客戶端發送包含命令和參數的HTTP請求到/message端點。
2. 服務器接收並解析請求。
3. 根據請求內容執行相應的數據庫查詢或API調用。
4. 處理結果並將其格式化為JSON響應。
5. 將響應返回給客戶端。

📚 詳細文檔

配置指南

環境變量

以下是運行服務器所需的關鍵環境變量：

• STEAM_API_KEY：必填。用於訪問Steam API的密鑰。
• DB_URI：可選。用於連接數據庫的URI（如果需要持久化存儲）。

可用命令

以下是一些當前實現的MCP（遊戲數據交換協議）命令：

• getCurrentPlayers
• getAppDetails
• getGameSchema
• getGameNews
• getPlayerAchievements
• getUserStatsForGame
• getGlobalStatsForGame
• getSupportedApiList
• getAppList
• getGlobalAchievementPercentages

如需詳細信息，請參考steamstats_mcpSpecification.md文檔。

連接本地MCP客戶端（例如Roo）

1. 確保服務器正在運行。
2. 打開客戶端的配置文件（通常位於.roo/mcp.json）。
3. 添加以下內容：

   {
     "servers": [
       // 其他服務器配置...
       {
         "name": "steamstats-local",
         "type": "sse",
         "enabled": true,
         "url": "http://localhost:8000/message",
         "readTimeoutSeconds": 60,
         "writeTimeoutSeconds": 60
       }
     ]
   }
   

4. 保存文件並重新啟動客戶端。

⚠️ 重要提示

當前實現不可用！

希望本指南能幫助您順利使用蒸汽統計數據服務器！