steam-review-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 fenx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# Steam Review MCP
+
+**English** | [中文](./README.zh.md)
+
+Access Steam game reviews using Model Context Protocol (MCP).
+
+## Features
+
+Helps LLMs retrieve Steam game reviews and information:
+
+- Get game reviews (positive/negative counts, review scores, review content, etc.)
+- Get game basic information (name, detailed description)
+- Analyze game reviews and summarize pros and cons
+
+## Installation
+
+Or run it directly with npx:
+
+```bash
+npx steam-review-mcp
+```
+
+## Usage
+
+### Tools
+
+This MCP service provides the `get_steam_review` tool, which retrieves reviews and game information by passing a Steam game appid.
+
+For more details, check the Steamwork API: [User Reviews - Get List](https://partner.steamgames.com/doc/store/getreviews)
+
+The returned data contains two parts:
+
+1. `game_reviews`:
+   - `success`: Whether the query was successful
+   - `review_score`: Review score
+   - `review_score_desc`: Review score description
+   - `total_positive`: Total positive reviews
+   - `total_negative`: Total negative reviews
+   - `reviews`: All review text content (without other metadata)
+
+2. `game_info`:
+   - `name`: Game name
+   - `detailed_description`: Detailed game description
+
+### Prompts
+
+#### summarize-reviews
+
+For overall game review analysis, summarizing the pros and cons of the game.
+
+##### Parameters
+
+- `appid` (required): Steam game ID, e.g., `570` (Dota 2)
+
+
+#### recent-reviews-analysis
+
+For analyzing recent game reviews, summarizing the current state of the game and player feedback.
+
+##### Parameters
+
+- `appid` (required): Steam game ID, e.g., `570` (Dota 2)
+
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build project
+npm run build
+
+# Run service
+npm start
+```

package/README.zh.md

@@ -0,0 +1,76 @@
+# Steam Review MCP
+
+[English](./README.md) | **中文**
+
+使用 Model Context Protocol (MCP) 获取 Steam 游戏评测。
+
+## 功能
+
+帮助 LLM 获取 Steam 游戏的评测和游戏信息：
+
+- 获取游戏评测（正面/负面评价数量、评测分数、评测内容等）
+- 获取游戏基本信息（名称、详细描述）
+- 分析游戏评测，总结游戏的优缺点
+
+## 安装
+
+或者直接使用 npx 运行：
+
+```bash
+npx steam-review-mcp
+```
+
+## 使用方法
+
+### 工具 (Tools)
+
+这个 MCP 服务提供了 `get_steam_review` 工具，可以通过传入 Steam 游戏的 appid 来获取评测和游戏信息。
+
+详细可查看 Steamwork API: [User Reviews - Get List](https://partner.steamgames.com/doc/store/getreviews)
+
+返回的数据包含两部分：
+
+1. `game_reviews`：
+   - `success`：查询是否成功
+   - `review_score`：评测分数
+   - `review_score_desc`：评测分数描述
+   - `total_positive`：正面评测总数
+   - `total_negative`：负面评测总数
+   - `reviews`：所有评测的文本内容（不包含其他元数据）
+
+2. `game_info`：
+   - `name`：游戏名称
+   - `detailed_description`：游戏详细描述
+
+### 提示模板 (Prompts)
+
+#### summarize-reviews
+
+用于游戏的整体分析游戏评测，总结游戏的优缺点。
+
+##### 参数
+
+- `appid`（必需）：Steam 游戏的 ID，例如 `570`（Dota 2）
+
+
+#### recent-reviews-analysis
+
+用于分析游戏的最近评测，总结游戏的当前状态和玩家反馈。
+
+##### 参数
+
+- `appid`（必需）：Steam 游戏的 ID，例如 `570`（Dota 2）
+
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建项目
+npm run build
+
+# 运行服务
+npm start
+``` 

package/build/index.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const STEAM_API_BASE = "https://store.steampowered.com/";
+const USER_AGENT = "steam-mcp/1.0";
+// Helper function to clean and format review text for JSON
+function cleanReviewText(text) {
+    if (!text)
+        return "";
+    // Remove HTML tags
+    let cleanText = text.replace(/<\/?[^>]+(>|$)/g, "");
+    // Decode common HTML entities
+    cleanText = cleanText.replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, "")
+        .replace(/&#39;/g, "")
+        .replace(/&nbsp;/g, " ");
+    // Handle newlines and other control characters
+    cleanText = cleanText.replace(/\r\n/g, "\\n")
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\n");
+    // Remove quotes
+    cleanText = cleanText.replace(/["']/g, "");
+    // Replace multiple spaces with a single space
+    cleanText = cleanText.replace(/\s+/g, " ");
+    // Trim extra spaces
+    return cleanText.trim();
+}
+// Create server instance
+const server = new McpServer({
+    name: "steam-review-mcp",
+    version: "1.0.0",
+});
+// Define the schema for the input parameters
+const SteamReviewParamsSchema = {
+    appid: z.string().describe("Steam application ID"),
+    filter: z.string().default("all").describe("recent: sorted by creation time, updated: sorted by last updated time,all: (default) sorted by helpfulness, with sliding windows based on day_range parameter, will always find results to return."),
+    language: z.enum([
+        "all", "arabic", "bulgarian", "schinese", "tchinese", "czech", "danish",
+        "dutch", "english", "finnish", "french", "german", "greek", "hungarian",
+        "indonesian", "italian", "japanese", "koreana", "norwegian", "polish",
+        "portuguese", "brazilian", "romanian", "russian", "spanish", "latam",
+        "swedish", "thai", "turkish", "ukrainian", "vietnamese"
+    ]).default("all").describe("Language filter (e.g. english, french, schinese). Default is all languages."),
+    day_range: z.number().default(365).describe("range from now to n days ago to look for helpful reviews. Only applicable for the all filter."),
+    cursor: z.string().default("*").describe("reviews are returned in batches of 20, so pass * for the first set, then the value of cursor that was returned in the response for the next set, etc. Note that cursor values may contain characters that need to be URLEncoded for use in the querystring."),
+    review_type: z.string().default("all").describe("all:all reviews (default), positive: only positive reviews, negative: only negative reviews"),
+    purchase_type: z.string().default("steam").describe("all: all reviews, non_steam_purchase: reviews written by users who did not pay for the product on Steam,steam: reviews written by users who paid for the product on Steam (default)"),
+    num_per_page: z.number().default(50).describe("number of reviews to get, max 100, default 50"),
+};
+// Add the tool to get steam reviews
+server.tool("get_steam_review", SteamReviewParamsSchema, async (params) => {
+    try {
+        // Fetch game reviews
+        const reviewsUrl = new URL(`appreviews/${params.appid}`, STEAM_API_BASE);
+        reviewsUrl.searchParams.append("json", "1");
+        reviewsUrl.searchParams.append("filter", params.filter);
+        reviewsUrl.searchParams.append("language", params.language);
+        reviewsUrl.searchParams.append("day_range", params.day_range.toString());
+        reviewsUrl.searchParams.append("cursor", params.cursor);
+        reviewsUrl.searchParams.append("review_type", params.review_type);
+        reviewsUrl.searchParams.append("purchase_type", params.purchase_type);
+        reviewsUrl.searchParams.append("num_per_page", params.num_per_page.toString());
+        const reviewsResponse = await fetch(reviewsUrl, {
+            headers: { "User-Agent": USER_AGENT }
+        });
+        if (!reviewsResponse.ok) {
+            throw new Error(`Failed to fetch reviews: ${reviewsResponse.statusText}`);
+        }
+        const reviewsData = await reviewsResponse.json();
+        // Extract required review information and review texts
+        const game_reviews = {
+            success: reviewsData.success,
+            review_score: reviewsData.query_summary?.review_score,
+            review_score_desc: reviewsData.query_summary?.review_score_desc,
+            total_positive: reviewsData.query_summary?.total_positive,
+            total_negative: reviewsData.query_summary?.total_negative,
+            reviews: reviewsData.reviews ? reviewsData.reviews.map((review) => cleanReviewText(review.review)) : []
+        };
+        // Fetch game info
+        const infoUrl = new URL("api/appdetails", STEAM_API_BASE);
+        infoUrl.searchParams.append("appids", params.appid);
+        const infoResponse = await fetch(infoUrl, {
+            headers: { "User-Agent": USER_AGENT }
+        });
+        if (!infoResponse.ok) {
+            throw new Error(`Failed to fetch game info: ${infoResponse.statusText}`);
+        }
+        const infoData = await infoResponse.json();
+        // Extract required game information
+        const game_info = {
+            name: infoData[params.appid]?.data?.name,
+            detailed_description: infoData[params.appid]?.data?.detailed_description
+        };
+        // Return combined result in the format expected by MCP
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ game_reviews, game_info }, null, 2)
+                }
+            ]
+        };
+    }
+    catch (error) {
+        console.error(error);
+        throw error;
+    }
+});
+// Add prompt for analyzing reviews
+server.prompt("summarize-reviews", { appid: z.string().describe("Steam application ID") }, async ({ appid }) => {
+    try {
+        // Fetch game reviews and info
+        const reviewsUrl = new URL(`appreviews/${appid}`, STEAM_API_BASE);
+        reviewsUrl.searchParams.append("json", "1");
+        reviewsUrl.searchParams.append("filter", "all");
+        reviewsUrl.searchParams.append("language", "all");
+        reviewsUrl.searchParams.append("day_range", "365");
+        reviewsUrl.searchParams.append("cursor", "*");
+        reviewsUrl.searchParams.append("review_type", "all");
+        reviewsUrl.searchParams.append("purchase_type", "all");
+        reviewsUrl.searchParams.append("num_per_page", "50");
+        const reviewsResponse = await fetch(reviewsUrl, {
+            headers: { "User-Agent": USER_AGENT }
+        });
+        if (!reviewsResponse.ok) {
+            throw new Error(`Failed to fetch reviews: ${reviewsResponse.statusText}`);
+        }
+        const reviewsData = await reviewsResponse.json();
+        // Extract required review information and review texts
+        const game_reviews = {
+            success: reviewsData.success,
+            review_score: reviewsData.query_summary?.review_score,
+            review_score_desc: reviewsData.query_summary?.review_score_desc,
+            total_positive: reviewsData.query_summary?.total_positive,
+            total_negative: reviewsData.query_summary?.total_negative,
+            reviews: reviewsData.reviews ? reviewsData.reviews.map((review) => cleanReviewText(review.review)) : []
+        };
+        // Fetch game info
+        const infoUrl = new URL("api/appdetails", STEAM_API_BASE);
+        infoUrl.searchParams.append("appids", appid);
+        const infoResponse = await fetch(infoUrl, {
+            headers: { "User-Agent": USER_AGENT }
+        });
+        if (!infoResponse.ok) {
+            throw new Error(`Failed to fetch game info: ${infoResponse.statusText}`);
+        }
+        const infoData = await infoResponse.json();
+        // Extract required game information
+        const game_info = {
+            name: infoData[appid]?.data?.name,
+            detailed_description: infoData[appid]?.data?.detailed_description
+        };
+        // Return prompt with game data
+        return {
+            messages: [{
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `You are an experienced video game industry professional and game developer who has played many games on Steam. You are skilled at summarizing a game's **pros** and **cons** from game reviews {{game_reviews}} combined with game descriptions {{game_info}}. List them in an unordered list format.
+                    ====
+                    # Features
+                    - Don't extract too much information from a single review; try to summarize from **multiple reviews and multiple perspectives**.
+                    - **Don't include too much game introduction content**; focus on finding common points in each review as game features.
+                    - **Don't just summarize the game description content**; extract pros and cons from the reviews, keeping the content relevant.
+                    ====
+                    # Format
+                    Pros:
+                    - Pro 1
+                    - Pro 2
+                    Cons:
+                    - Con 1
+                    - Con 2
+                    The unordered list format should be arranged from top to bottom according to the **number of times each pro or con is mentioned**.
+
+                    Game Info: ${JSON.stringify(game_info, null, 2)}
+                    Game Reviews: ${JSON.stringify(game_reviews.reviews, null, 2)}`
+                    }
+                }]
+        };
+    }
+    catch (error) {
+        console.error(error);
+        throw error;
+    }
+});
+// Add prompt for analyzing recent reviews
+server.prompt("recent-reviews-analysis", { appid: z.string().describe("Steam application ID") }, async ({ appid }) => {
+    try {
+        // Fetch game reviews and info
+        const reviewsUrl = new URL(`appreviews/${appid}`, STEAM_API_BASE);
+        reviewsUrl.searchParams.append("json", "1");
+        reviewsUrl.searchParams.append("filter", "recent");
+        reviewsUrl.searchParams.append("language", "all");
+        reviewsUrl.searchParams.append("day_range", "365");
+        reviewsUrl.searchParams.append("cursor", "*");
+        reviewsUrl.searchParams.append("review_type", "all");
+        reviewsUrl.searchParams.append("purchase_type", "all");
+        reviewsUrl.searchParams.append("num_per_page", "50");
+        const reviewsResponse = await fetch(reviewsUrl, {
+            headers: { "User-Agent": USER_AGENT }
+        });
+        if (!reviewsResponse.ok) {
+            throw new Error(`Failed to fetch reviews: ${reviewsResponse.statusText}`);
+        }
+        const reviewsData = await reviewsResponse.json();
+        // Extract required review information and review texts
+        const game_reviews = {
+            success: reviewsData.success,
+            review_score: reviewsData.query_summary?.review_score,
+            review_score_desc: reviewsData.query_summary?.review_score_desc,
+            total_positive: reviewsData.query_summary?.total_positive,
+            total_negative: reviewsData.query_summary?.total_negative,
+            reviews: reviewsData.reviews ? reviewsData.reviews.map((review) => cleanReviewText(review.review)) : []
+        };
+        // Fetch game info
+        const infoUrl = new URL("api/appdetails", STEAM_API_BASE);
+        infoUrl.searchParams.append("appids", appid);
+        const infoResponse = await fetch(infoUrl, {
+            headers: { "User-Agent": USER_AGENT }
+        });
+        if (!infoResponse.ok) {
+            throw new Error(`Failed to fetch game info: ${infoResponse.statusText}`);
+        }
+        const infoData = await infoResponse.json();
+        // Extract required game information
+        const game_info = {
+            name: infoData[appid]?.data?.name,
+            detailed_description: infoData[appid]?.data?.detailed_description
+        };
+        // Return prompt with game data
+        return {
+            messages: [{
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `You are an experienced video game industry professional and game developer who has played many games on Steam. You are skilled at summarizing a game's **recent performance and player feedback** from the most recent game reviews {{game_reviews}} combined with game descriptions {{game_info}}. List them in an unordered list format.
+                  ====
+                  # Features
+                  - Don't extract too much information from a single review; try to summarize from **multiple reviews and multiple perspectives**.
+                  - **Don't include too much game introduction content**; focus on finding common points in each review as game features.
+                  - **Don't just summarize the game description content**; extract pros and cons from the reviews, keeping the content relevant.
+                  - Specifically focus on **recent changes, updates, and current player sentiment**.
+                  ====
+                  # Format
+                  Pros:
+                  - Pro 1
+                  - Pro 2
+                  Cons:
+                  - Con 1
+                  - Con 2
+                  Current Player Sentiment:
+                  - Key point about current state of the game
+                  The unordered list format should be arranged from top to bottom according to the **number of times each point is mentioned**.
+
+                  Game Info: ${JSON.stringify(game_info, null, 2)}
+                  Game Reviews: ${JSON.stringify(game_reviews.reviews, null, 2)}`
+                    }
+                }]
+        };
+    }
+    catch (error) {
+        console.error(error);
+        throw error;
+    }
+});
+// Start the server
+const transport = new StdioServerTransport();
+server.connect(transport).catch(console.error);
+console.log("Steam Review MCP Server started");

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "steam-review-mcp",
+  "version": "1.0.0",
+  "description": "Get reviews from steam store with appid",
+  "main": "build/index.js",
+  "type": "module",
+  "bin": {
+    "steam-review-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsc && node build/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fenxer/steam-review-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "steam",
+    "review",
+    "modelcontextprotocol"
+  ],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/fenxer/steam-review-mcp/issues"
+  },
+  "homepage": "https://github.com/fenxer/steam-review-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.7.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2"
+  },
+  "files": [
+    "build/**/*"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}