@witchpot/steamboard-mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-02-14
+
+### Added
+- Initial release
+- `search_games` tool - Search Steam games with advanced filters
+  - Filter by tags, price range, review count, ratings
+  - Support for release date filtering
+  - Flexible sorting options
+- `analyze_tag_combinations` tool - Analyze tag combinations for market research
+  - Group by primary tag, tag pairs, or tag triples
+  - Calculate success rates with custom criteria
+  - Identify oversaturated/undersaturated markets
+- `find_similar_games` tool - Find games similar to a specific title
+  - Tag-based similarity scoring
+  - Configurable generic tag exclusion
+  - Minimum review filtering
+- `analyze_related_tags` tool - Analyze tag co-occurrence patterns
+  - Find tags that complement a given tag set
+  - Calculate success rate impact (delta)
+  - Discover differentiation opportunities
+
+### Notes
+- Time-series analysis tools (`get_app_snapshots`, `get_review_growth`) are temporarily disabled pending sufficient historical data collection

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Witchpot Studio
+
+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,282 @@
+# @witchpot/steamboard-mcp
+
+[![npm version](https://badge.fury.io/js/%40witchpot%2Fsteamboard-mcp.svg)](https://www.npmjs.com/package/@witchpot/steamboard-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A Model Context Protocol (MCP) server for Steam game market research and analytics. This server provides AI assistants with tools to search Steam games, analyze tag combinations, find similar games, and discover related tags.
+
+## Features
+
+- **search_games** - Search Steam games with advanced filters (tags, price, reviews, ratings, release date)
+- **analyze_tag_combinations** - Discover successful niche markets and identify oversaturated/undersaturated genre combinations
+- **find_similar_games** - Find games similar to a specific title based on tag matching
+- **analyze_related_tags** - Discover which tags work well together and their impact on success rates
+
+## Design Philosophy
+
+This MCP exposes **absolute value parameters** (reviewsMin, priceMax, etc.) rather than predefined buckets. This allows AI agents to define their own criteria based on context, user preferences, and domain knowledge.
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Access to a SteamDashboard API instance (provides the underlying data)
+
+## Installation
+
+### Using npx (Recommended)
+
+```bash
+npx @witchpot/steamboard-mcp
+```
+
+### Global Installation
+
+```bash
+npm install -g @witchpot/steamboard-mcp
+```
+
+### Local Installation
+
+```bash
+npm install @witchpot/steamboard-mcp
+```
+
+## Configuration
+
+The server requires the following environment variables:
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `STEAM_DASHBOARD_API_KEY` | Yes | - | API key for SteamDashboard authentication |
+| `STEAM_DASHBOARD_API_URL` | No | `http://localhost:3001` | SteamDashboard API base URL |
+
+## Usage with Claude Desktop
+
+Add the following to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "steamboard": {
+      "command": "npx",
+      "args": ["-y", "@witchpot/steamboard-mcp"],
+      "env": {
+        "STEAM_DASHBOARD_API_URL": "https://your-steamdashboard-api.com",
+        "STEAM_DASHBOARD_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Usage with Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "steamboard": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@witchpot/steamboard-mcp"],
+      "env": {
+        "STEAM_DASHBOARD_API_URL": "https://your-steamdashboard-api.com",
+        "STEAM_DASHBOARD_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### search_games
+
+Search Steam games with advanced filters including tags, price ranges, review counts, ratings, and scale buckets.
+
+**Parameters:**
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `tags` | string[] | Filter by Steam tags (e.g., ["roguelike", "action"]) |
+| `tagMode` | "and" \| "or" | Tag matching mode (default: "and") |
+| `minReviews` / `maxReviews` | number | Review count range |
+| `minRating` / `maxRating` | number | Rating percentage range (0-100) |
+| `minPrice` / `maxPrice` | number | Price range in cents |
+| `popularityBuckets` | string[] | Filter by popularity tier |
+| `productionBuckets` | string[] | Filter by production scale |
+| `releasedAfter` / `releasedBefore` | string | Release date range (YYYY-MM-DD) |
+| `sort` | string | Sort order (reviews_desc, rating_desc, price_asc, etc.) |
+| `limit` | number | Max results (default: 20, max: 100) |
+
+**Example:**
+```
+Search for roguelike action games with at least 1000 reviews
+```
+
+---
+
+### analyze_tag_combinations
+
+Analyze tag combinations to discover successful niche markets and identify oversaturated/undersaturated genre combinations.
+
+**Parameters:**
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `groupBy` | string | **Required.** Grouping: "primary_tag", "tag_pair", "tag_triple" |
+| `tags` | string[] | Filter to combinations containing these tags |
+| `tagMode` | "and" \| "or" | Tag matching mode |
+| `popularityBuckets` | string[] | Filter by popularity tier |
+| `productionBuckets` | string[] | Filter by production scale |
+| `minReviews` | number | Minimum reviews for inclusion |
+| `ratingMin` | number | Minimum rating for inclusion |
+| `successReviewsMin` | number | Reviews threshold for "success" |
+| `successRatingMin` | number | Rating threshold for "success" |
+| `limit` | number | Max results (default: 20, max: 100) |
+
+**Example:**
+```
+Analyze tag pairs containing "roguelike" to find underserved niches
+```
+
+---
+
+### find_similar_games
+
+Find games similar to a specific game based on tag matching. Returns games sorted by similarity score (tag overlap).
+
+**Parameters:**
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `appid` | number | **Required.** Steam App ID of the base game |
+| `limit` | number | Max results (default: 20, max: 100) |
+| `excludeGeneric` | boolean | Exclude generic tags from calculation (default: true) |
+| `minReviews` | number | Minimum reviews for similar games (default: 0) |
+
+**Example:**
+```
+Find games similar to Hades (appid: 1145360)
+```
+
+---
+
+### analyze_related_tags
+
+Analyze tag co-occurrence to find tags that work well with a given tag set. Shows which tags appear frequently with your base tags and how they affect success rate.
+
+**Parameters:**
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `baseTags` | string[] | **Required.** Base tags to analyze (e.g., ["roguelike", "action"]) |
+| `baseTagMode` | "and" \| "or" | Tag matching mode for base tags (default: "and") |
+| `excludeGeneric` | boolean | Exclude generic tags from results (default: true) |
+| `minCoOccurrence` | number | Minimum games with the related tag (default: 5) |
+| `successReviewsMin` | number | Reviews threshold for "success" |
+| `successRatingMin` | number | Rating threshold for "success" |
+| `limit` | number | Max results (default: 30, max: 100) |
+
+**Response includes:**
+- `co_occurrence_rate` - How often this tag appears with base tags
+- `success_rate` - Success rate of games with base tags + this tag
+- `success_rate_delta` - Change in success rate when adding this tag
+
+**Example:**
+```
+What tags work well with "roguelike + action"?
+```
+
+## Recommended Thresholds
+
+Since this MCP uses absolute values, here are recommended thresholds that agents can use as guidelines:
+
+### Popularity (by review count)
+| Category | Review Count | Description |
+|----------|-------------|-------------|
+| Niche/New | 0-100 | Recently released or very niche |
+| Small | 100-1,000 | Small but established audience |
+| Medium | 1,000-10,000 | Growing audience |
+| Popular | 10,000-100,000 | Well-known games |
+| Massive | 100,000+ | Mainstream hits |
+
+### Production Scale (by price in USD)
+| Category | Price Range | Description |
+|----------|-------------|-------------|
+| F2P | $0 | Free-to-play |
+| Indie | $0.01-25 | Small team / solo dev |
+| AA | $25-50 | Mid-size studio |
+| AAA | $50+ | Large studio |
+
+### Success Criteria
+| Level | Reviews | Rating | Description |
+|-------|---------|--------|-------------|
+| Minimum Viable | 500+ | 70%+ | Has some traction |
+| Successful | 1,000+ | 80%+ | Clearly successful |
+| Hit | 10,000+ | 85%+ | Major success |
+
+## Use Cases
+
+### For Game Developers
+
+- **Market Research**: Identify underserved niches with high success rates
+- **Competitive Analysis**: Find similar games to understand your competition
+- **Tag Optimization**: Discover which tag combinations lead to better visibility and success
+- **Trend Analysis**: Explore popular and emerging genre combinations
+
+### For Market Analysts
+
+- **Genre Mapping**: Understand the Steam game landscape by tag combinations
+- **Success Patterns**: Identify what makes games successful in specific niches
+- **Market Gaps**: Find opportunities in undersaturated markets
+
+## Architecture
+
+```
+AI Agent (Claude / other LLMs)
+       ↓
+   MCP Protocol (stdio)
+       ↓
+  @witchpot/steamboard-mcp (this package)
+       ↓
+  SteamDashboard REST API
+       ↓
+  Supabase (PostgreSQL)
+```
+
+## API Backend
+
+This MCP server requires a running instance of SteamDashboard API. The SteamDashboard is a separate service that:
+
+- Collects and stores Steam game data via ETL pipeline
+- Provides REST API endpoints for game search and analysis
+- Maintains daily snapshots for time-series analysis
+
+Contact Witchpot Studio for API access or self-hosting options.
+
+## Troubleshooting
+
+### "STEAM_DASHBOARD_API_KEY environment variable is required"
+Set the API key in your environment or MCP configuration.
+
+### "Steamboard API error (401)"
+Check that your API key is valid.
+
+### "Connection refused"
+Ensure SteamDashboard API is running and accessible at the configured URL.
+
+## Roadmap
+
+- [ ] Time-series analysis tools (tracking historical data)
+- [ ] VLM integration for visual analysis
+- [ ] Caching layer for expensive queries
+- [ ] Rate limiting and request optimization
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Support
+
+For support and inquiries, contact Witchpot Studio.

package/build/clients/steam-api-client.d.ts

@@ -0,0 +1,112 @@
+/**
+ * SteamDashboard API Client
+ * Provides typed access to SteamDashboard REST API endpoints
+ */
+import type { SearchAppsResponse, AppSnapshotsResponse, ReviewGrowthResponse, TagAnalysisResponse, SimilarGamesResponse, RelatedTagsResponse, SortOption, TagMode } from './types.js';
+export interface SteamApiClientConfig {
+    apiUrl: string;
+    apiKey: string;
+}
+export interface SearchGamesParams {
+    keyword?: string;
+    tags?: string[];
+    tagMode?: TagMode;
+    priceMin?: number;
+    priceMax?: number;
+    reviewsMin?: number;
+    reviewsMax?: number;
+    ratingMin?: number;
+    discountMin?: number;
+    releaseFrom?: string;
+    releaseTo?: string;
+    upcomingOnly?: boolean;
+    sort?: SortOption;
+    page?: number;
+    limit?: number;
+}
+export interface GetSnapshotsParams {
+    appid: number;
+    from?: string;
+    to?: string;
+}
+export interface GetReviewGrowthParams {
+    from: string;
+    to: string;
+    tags?: string[];
+    tagMode?: TagMode;
+    reviewsMin?: number;
+    reviewsMax?: number;
+    sortBy?: 'growth_rate' | 'absolute_growth';
+    limit?: number;
+}
+export interface AnalyzeTagsParams {
+    groupBy: 'single_tag' | 'tag_combination';
+    tags?: string[];
+    tagMode?: TagMode;
+    reviewsMin?: number;
+    reviewsMax?: number;
+    priceMin?: number;
+    priceMax?: number;
+    ratingMin?: number;
+    successReviewsMin?: number;
+    successRatingMin?: number;
+    combinationSize?: number;
+    limit?: number;
+}
+export interface GetSimilarGamesParams {
+    appid: number;
+    limit?: number;
+    excludeGeneric?: boolean;
+    minReviews?: number;
+}
+export interface GetRelatedTagsParams {
+    baseTags: string[];
+    baseTagMode?: TagMode;
+    excludeGeneric?: boolean;
+    minCoOccurrence?: number;
+    successReviewsMin?: number;
+    successRatingMin?: number;
+    limit?: number;
+}
+export declare class SteamApiClient {
+    private readonly apiUrl;
+    private readonly apiKey;
+    constructor(config: SteamApiClientConfig);
+    /**
+     * Build URL with query parameters
+     */
+    private buildUrl;
+    /**
+     * Make authenticated GET request
+     */
+    private request;
+    /**
+     * Make authenticated POST request with JSON body
+     */
+    private postRequest;
+    /**
+     * Search Steam games with filters
+     */
+    searchGames(params: SearchGamesParams): Promise<SearchAppsResponse>;
+    /**
+     * Get time-series snapshot data for a specific app
+     */
+    getAppSnapshots(params: GetSnapshotsParams): Promise<AppSnapshotsResponse>;
+    /**
+     * Get review growth analytics between two dates
+     */
+    getReviewGrowth(params: GetReviewGrowthParams): Promise<ReviewGrowthResponse>;
+    /**
+     * Analyze tag combinations and success rates
+     */
+    analyzeTags(params: AnalyzeTagsParams): Promise<TagAnalysisResponse>;
+    /**
+     * Find games similar to a specific app based on tag matching
+     */
+    getSimilarGames(params: GetSimilarGamesParams): Promise<SimilarGamesResponse>;
+    /**
+     * Analyze related tags (co-occurrence) for a given tag set
+     */
+    getRelatedTags(params: GetRelatedTagsParams): Promise<RelatedTagsResponse>;
+}
+//# sourceMappingURL=steam-api-client.d.ts.map

package/build/clients/steam-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steam-api-client.d.ts","sourceRoot":"","sources":["../../src/clients/steam-api-client.ts"],"names":[],"mappings":"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"}

package/build/clients/steam-api-client.js

@@ -0,0 +1,171 @@
+/**
+ * SteamDashboard API Client
+ * Provides typed access to SteamDashboard REST API endpoints
+ */
+export class SteamApiClient {
+    apiUrl;
+    apiKey;
+    constructor(config) {
+        this.apiUrl = config.apiUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.apiKey = config.apiKey;
+    }
+    /**
+     * Build URL with query parameters
+     */
+    buildUrl(endpoint, params) {
+        const url = new URL(endpoint, this.apiUrl);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    if (Array.isArray(value)) {
+                        url.searchParams.set(key, value.join(','));
+                    }
+                    else {
+                        url.searchParams.set(key, String(value));
+                    }
+                }
+            });
+        }
+        return url.toString();
+    }
+    /**
+     * Make authenticated GET request
+     */
+    async request(endpoint, params) {
+        const url = this.buildUrl(endpoint, params);
+        const response = await fetch(url, {
+            headers: {
+                'X-API-Key': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`SteamDashboard API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Make authenticated POST request with JSON body
+     */
+    async postRequest(endpoint, body) {
+        const url = `${this.apiUrl}${endpoint}`;
+        // Filter out undefined values from body
+        const filteredBody = Object.fromEntries(Object.entries(body).filter(([_, value]) => value !== undefined && value !== null));
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'X-API-Key': this.apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(filteredBody),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`SteamDashboard API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Search Steam games with filters
+     */
+    async searchGames(params) {
+        return this.request('/api/v1/apps', {
+            q: params.keyword,
+            tags: params.tags,
+            tagMode: params.tagMode,
+            priceMin: params.priceMin,
+            priceMax: params.priceMax,
+            reviewsMin: params.reviewsMin,
+            reviewsMax: params.reviewsMax,
+            ratingMin: params.ratingMin,
+            discountMin: params.discountMin,
+            releaseFrom: params.releaseFrom,
+            releaseTo: params.releaseTo,
+            upcomingOnly: params.upcomingOnly,
+            sort: params.sort,
+            page: params.page,
+            pageSize: params.limit,
+        });
+    }
+    /**
+     * Get time-series snapshot data for a specific app
+     */
+    async getAppSnapshots(params) {
+        return this.request(`/api/v1/apps/${params.appid}/snapshots`, {
+            from: params.from,
+            to: params.to,
+        });
+    }
+    /**
+     * Get review growth analytics between two dates
+     */
+    async getReviewGrowth(params) {
+        return this.request('/api/v1/analytics/review-growth', {
+            from: params.from,
+            to: params.to,
+            tags: params.tags,
+            tagMode: params.tagMode,
+            // Map MCP params to API params
+            minReviewsFrom: params.reviewsMin,
+            // Note: reviewsMax is not currently supported by the API
+            sortBy: params.sortBy,
+            limit: params.limit,
+        });
+    }
+    /**
+     * Analyze tag combinations and success rates
+     */
+    async analyzeTags(params) {
+        // Build successMetric object if success criteria provided
+        const successMetric = params.successReviewsMin || params.successRatingMin
+            ? {
+                minReviews: params.successReviewsMin,
+                minRating: params.successRatingMin,
+            }
+            : undefined;
+        return this.postRequest('/api/v1/analyze', {
+            groupBy: params.groupBy,
+            tags: params.tags,
+            tagMode: params.tagMode,
+            reviewsMin: params.reviewsMin,
+            reviewsMax: params.reviewsMax,
+            priceMin: params.priceMin,
+            priceMax: params.priceMax,
+            ratingMin: params.ratingMin,
+            successMetric,
+            combinationSize: params.combinationSize,
+            outputLimit: params.limit,
+        });
+    }
+    /**
+     * Find games similar to a specific app based on tag matching
+     */
+    async getSimilarGames(params) {
+        return this.request(`/api/v1/apps/${params.appid}/similar`, {
+            limit: params.limit,
+            excludeGeneric: params.excludeGeneric,
+            minReviews: params.minReviews,
+        });
+    }
+    /**
+     * Analyze related tags (co-occurrence) for a given tag set
+     */
+    async getRelatedTags(params) {
+        const successMetric = params.successReviewsMin || params.successRatingMin
+            ? {
+                minReviews: params.successReviewsMin,
+                minRating: params.successRatingMin,
+            }
+            : undefined;
+        return this.postRequest('/api/v1/analyze/related-tags', {
+            baseTags: params.baseTags,
+            baseTagMode: params.baseTagMode,
+            excludeGeneric: params.excludeGeneric,
+            minCoOccurrence: params.minCoOccurrence,
+            successMetric,
+            limit: params.limit,
+        });
+    }
+}
+//# sourceMappingURL=steam-api-client.js.map

package/build/clients/steam-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steam-api-client.js","sourceRoot":"","sources":["../../src/clients/steam-api-client.ts"],"names":[],"mappings":"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"}