@mrfentmen/steam-mcp 1.0.0 → 1.0.1

package/README.md

@@ -1,13 +1,13 @@
-# steam-mcp
+# steam mcp
 
 Steam store search, prices and discounts, app details, and game news.
 Uses Steam's keyless store + news endpoints.
 
 ## Tools
 
-- `search_games` — store search with current prices / discount percentages
-- `get_game_details` — price, release date, developers, genres, Metacritic, blurb
-- `get_game_news` — recent Steam news posts for a game
+- `search_games`, store search with current prices / discount percentages
+- `get_game_details`, price, release date, developers, genres, Metacritic, blurb
+- `get_game_news`, recent Steam news posts for a game
 
 ## Run
 
@@ -22,3 +22,27 @@ npm install && npm run build && node dist/index.js
 
 > "What's new for Cyberpunk?"
 > `get_game_news(1091500)`
+
+## Quick start
+
+```bash
+npm install
+npm run build
+node dist/index.js
+```
+
+The server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code, MCP Inspector, or another compatible MCP client.
+
+## Tools at a glance
+
+- `search_games`: Search the Steam store by title. Returns appids with current prices
+- `get_game_details`: Get details for a Steam app: price/discount, release date,
+- `get_game_news`: Fetch recent Steam news posts for a game.
+
+## Limits and privacy
+
+This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. No credentials are required unless the project explicitly says otherwise.
+
+## Try it
+
+After building, connect the server through your MCP client. The repository root also contains `smoke-test.mjs` for projects covered by the shared harness. A typical tool call starts with `search_games`.

package/dist/server.js

@@ -2,13 +2,20 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { SteamError, formatAppDetail, formatStoreItem, getAppDetail, getNews, searchStore, } from "./api.js";
 const text = (t) => ({ content: [{ type: "text", text: t }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
 export function createServer() {
     const server = new McpServer({
         name: "steam-mcp",
         version: "1.0.0",
     });
-    server.tool("search_games", "Search the Steam store by title. Returns appids with current prices " +
-        "and discounts.", { query: z.string().describe("Game title, e.g. 'Helldivers' or 'Baldur'") }, async ({ query }) => {
+    server.registerTool("search_games", {
+        title: "Search games",
+        description: "Search the Steam store by title. Returns appids with current prices " +
+            "and discounts.",
+        inputSchema: z.object({ query: z.string().describe("Game title, e.g. 'Helldivers' or 'Baldur'") }),
+        annotations: READ_ONLY,
+    }, async ({ query }) => {
         try {
             const items = await searchStore(query);
             if (items.length === 0)
@@ -17,11 +24,16 @@ export function createServer() {
                 items.map((i, n) => `${n + 1}. ${formatStoreItem(i)}`).join("\n"));
         }
         catch (e) {
-            return text(errorMessage(e));
+            return textError(errorMessage(e));
         }
     });
-    server.tool("get_game_details", "Get details for a Steam app: price/discount, release date, " +
-        "developers, genres, Metacritic, description.", { appid: z.number().int().describe("Steam app id from search_games") }, async ({ appid }) => {
+    server.registerTool("get_game_details", {
+        title: "Get game details",
+        description: "Get details for a Steam app: price/discount, release date, " +
+            "developers, genres, Metacritic, description.",
+        inputSchema: z.object({ appid: z.number().int().describe("Steam app id from search_games") }),
+        annotations: READ_ONLY,
+    }, async ({ appid }) => {
         try {
             const detail = await getAppDetail(appid);
             if (!detail)
@@ -29,12 +41,17 @@ export function createServer() {
             return text(formatAppDetail(detail));
         }
         catch (e) {
-            return text(errorMessage(e));
+            return textError(errorMessage(e));
         }
     });
-    server.tool("get_game_news", "Fetch recent Steam news posts for a game.", {
-        appid: z.number().int().describe("Steam app id"),
-        count: z.number().int().min(1).max(20).default(5).describe("Number of posts"),
+    server.registerTool("get_game_news", {
+        title: "Get game news",
+        description: "Fetch recent Steam news posts for a game.",
+        inputSchema: z.object({
+            appid: z.number().int().describe("Steam app id"),
+            count: z.number().int().min(1).max(20).default(5).describe("Number of posts"),
+        }),
+        annotations: READ_ONLY,
     }, async ({ appid, count }) => {
         try {
             const news = await getNews(appid, count);
@@ -49,7 +66,7 @@ export function createServer() {
                     .join("\n\n"));
         }
         catch (e) {
-            return text(errorMessage(e));
+            return textError(errorMessage(e));
         }
     });
     return server;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mrfentmen/steam-mcp",
-  "version": "1.0.0",
-  "description": "MCP server for Steam — store search, prices and discounts, app details, and game news.",
+  "version": "1.0.1",
+  "description": "Use this MCP server to Steam, store search, prices and discounts, app details, and game news. Tools include search games, get game details, get game news",
   "type": "module",
   "mcpName": "io.github.mrfentmen/steam-mcp",
   "repository": {
@@ -37,5 +37,8 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
   }
 }