@mrfentmen/steam-mcp 1.0.0

package/README.md

@@ -0,0 +1,24 @@
+# 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
+
+## Run
+
+```bash
+npm install && npm run build && node dist/index.js
+```
+
+## Example
+
+> "What's Helldivers 2 cost and is it on sale?"
+> `search_games("helldivers")` → `get_game_details(553850)`
+
+> "What's new for Cyberpunk?"
+> `get_game_news(1091500)`

package/dist/api.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Steam client — keyless store endpoints.
+ *  - Store search:   /api/storesearch
+ *  - App details:    /api/appdetails   (filtered to keep payloads small)
+ *  - News:           ISteamNews/GetNewsForApp (Steamworks Web API, no key
+ *                    required for this endpoint)
+ */
+export declare class SteamError extends Error {
+}
+export interface StoreItem {
+    type: string;
+    appid: number;
+    name: string;
+    price?: {
+        currency: string;
+        initial: number;
+        final: number;
+        discount_percent: number;
+    };
+    tinyImage?: string;
+}
+export interface AppDetail {
+    appid: number;
+    name: string;
+    type?: string;
+    isFree?: boolean;
+    price: {
+        currency: string;
+        initial: number;
+        final: number;
+        discountPercent: number;
+    } | null;
+    releaseDate?: string;
+    developers: string[];
+    genres: string[];
+    metacritic?: number;
+    description?: string;
+    headerImage?: string;
+    url: string;
+}
+export interface NewsItem {
+    title: string;
+    url: string;
+    author?: string;
+    date?: string;
+    contents?: string;
+}
+export declare function searchStore(query: string): Promise<StoreItem[]>;
+export declare function getAppDetail(appid: number): Promise<AppDetail | null>;
+export declare function getNews(appid: number, count: number): Promise<NewsItem[]>;
+export declare function fmtPrice(cents: number, currency?: string): string;
+export declare function formatStoreItem(i: StoreItem): string;
+export declare function formatAppDetail(a: AppDetail): string;

package/dist/api.js

@@ -0,0 +1,120 @@
+/**
+ * Steam client — keyless store endpoints.
+ *  - Store search:   /api/storesearch
+ *  - App details:    /api/appdetails   (filtered to keep payloads small)
+ *  - News:           ISteamNews/GetNewsForApp (Steamworks Web API, no key
+ *                    required for this endpoint)
+ */
+const STORE = "https://store.steampowered.com/api";
+const NEWS = "https://api.steampowered.com/ISteamNews/GetNewsForApp/v2";
+export class SteamError extends Error {
+}
+async function getJson(url) {
+    const res = await fetch(url, {
+        headers: { Accept: "application/json", "User-Agent": "steam-mcp/1.0" },
+    });
+    if (!res.ok)
+        throw new SteamError(`Steam API error ${res.status}: ${res.statusText}`);
+    return (await res.json());
+}
+// ---------------------------------------------------------------------------
+// Endpoints
+// ---------------------------------------------------------------------------
+export async function searchStore(query) {
+    const data = await getJson(`${STORE}/storesearch/?term=${encodeURIComponent(query)}&cc=US&l=en`);
+    return (data.items ?? [])
+        .filter((i) => i.type === "app")
+        .slice(0, 12)
+        .map((i) => ({ ...i, appid: i.id }));
+}
+export async function getAppDetail(appid) {
+    const filters = [
+        "basic",
+        "price_overview",
+        "release_date",
+        "developers",
+        "genres",
+        "metacritic",
+        "short_description",
+        "header_image",
+    ].join(",");
+    const data = await getJson(`${STORE}/appdetails?appids=${appid}&cc=US&l=en&filters=${filters}`);
+    const entry = data[String(appid)];
+    if (!entry?.success || !entry.data)
+        return null;
+    const d = entry.data;
+    const price = d.price_overview;
+    return {
+        appid,
+        name: d.name ?? "?",
+        type: d.type,
+        isFree: d.is_free,
+        price: price
+            ? {
+                currency: price.currency ?? "USD",
+                initial: price.initial ?? 0,
+                final: price.final ?? 0,
+                discountPercent: price.discount_percent ?? 0,
+            }
+            : null,
+        releaseDate: d.release_date?.date,
+        developers: d.developers ?? [],
+        genres: (d.genres ?? []).map((g) => g.description),
+        metacritic: d.metacritic?.score,
+        description: d.short_description,
+        headerImage: d.header_image,
+        url: `https://store.steampowered.com/app/${appid}`,
+    };
+}
+export async function getNews(appid, count) {
+    const data = await getJson(`${NEWS}/?appid=${appid}&count=${count}&maxlength=600`);
+    return (data.appnews?.newsitems ?? []).map((n) => ({
+        title: n.title ?? "?",
+        url: n.url ?? "",
+        author: n.author,
+        date: n.date ? new Date(n.date * 1000).toISOString().slice(0, 10) : undefined,
+        contents: n.contents ? stripHtml(n.contents).slice(0, 300) : undefined,
+    }));
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+export function fmtPrice(cents, currency = "USD") {
+    const symbol = currency === "USD" ? "$" : `${currency} `;
+    return `${symbol}${(cents / 100).toFixed(2)}`;
+}
+export function formatStoreItem(i) {
+    const price = i.price
+        ? i.price.discount_percent > 0
+            ? `~~${fmtPrice(i.price.initial, i.price.currency)}~~ → **${fmtPrice(i.price.final, i.price.currency)}** (-${i.price.discount_percent}%)`
+            : fmtPrice(i.price.final, i.price.currency)
+        : "no price data";
+    return `[${i.appid}] ${i.name}\n   ${price}\n   https://store.steampowered.com/app/${i.appid}`;
+}
+export function formatAppDetail(a) {
+    const lines = [
+        `[${a.appid}] ${a.name}${a.type ? ` (${a.type})` : ""}`,
+        a.price
+            ? a.price.discountPercent > 0
+                ? `Price: ~~${fmtPrice(a.price.initial)}~~ → ${fmtPrice(a.price.final)} (-${a.price.discountPercent}%)`
+                : `Price: ${fmtPrice(a.price.final)}`
+            : a.isFree
+                ? "Free to play"
+                : "Price unavailable",
+        a.releaseDate ? `Released: ${a.releaseDate}` : "",
+        a.developers.length ? `Developers: ${a.developers.join(", ")}` : "",
+        a.genres.length ? `Genres: ${a.genres.join(", ")}` : "",
+        a.metacritic ? `Metacritic: ${a.metacritic}` : "",
+    ].filter(Boolean);
+    if (a.description)
+        lines.push(`\n${a.description}`);
+    lines.push(`\n${a.url}`);
+    return lines.join("\n");
+}
+function stripHtml(s) {
+    return s
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\[\[([^\]]*)\]\]/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Steam MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,63 @@
+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 }] });
+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 }) => {
+        try {
+            const items = await searchStore(query);
+            if (items.length === 0)
+                return text(`Nothing on Steam matches "${query}".`);
+            return text(`Steam results for "${query}":\n` +
+                items.map((i, n) => `${n + 1}. ${formatStoreItem(i)}`).join("\n"));
+        }
+        catch (e) {
+            return text(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 }) => {
+        try {
+            const detail = await getAppDetail(appid);
+            if (!detail)
+                return text(`No Steam app with id ${appid}.`);
+            return text(formatAppDetail(detail));
+        }
+        catch (e) {
+            return text(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"),
+    }, async ({ appid, count }) => {
+        try {
+            const news = await getNews(appid, count);
+            if (news.length === 0)
+                return text(`No news for app ${appid}.`);
+            return text(`Latest news for app ${appid}:\n` +
+                news
+                    .map((n, i) => `${i + 1}. ${n.title}${n.date ? ` (${n.date})` : ""}` +
+                    (n.author ? ` by ${n.author}` : "") +
+                    `\n   ${n.url}` +
+                    (n.contents ? `\n   ${n.contents}` : ""))
+                    .join("\n\n"));
+        }
+        catch (e) {
+            return text(errorMessage(e));
+        }
+    });
+    return server;
+}
+function errorMessage(e) {
+    if (e instanceof SteamError)
+        return `Error: ${e.message}`;
+    if (e instanceof Error)
+        return `Error: ${e.message}`;
+    return `Error: ${String(e)}`;
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@mrfentmen/steam-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Steam — store search, prices and discounts, app details, and game news.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/steam-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/steam-mcp.git"
+  },
+  "bin": {
+    "steam-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "rm -rf dist && tsc -p tsconfig.json && node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "steam",
+    "games",
+    "prices",
+    "store",
+    "deals"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}