igdb-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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,129 @@
+# IGDB MCP Server
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides access to the [IGDB (Internet Game Database)](https://www.igdb.com/) API. This allows AI assistants like Claude to search for games and retrieve detailed game information.
+
+## Features
+
+- **search_games** - Search for games by name, returning basic info including ratings, genres, platforms, and release dates
+- **get_game_details** - Get comprehensive details about a specific game including storyline, themes, and similar games
+
+## Prerequisites
+
+You need IGDB API credentials to use this server. IGDB uses Twitch authentication:
+
+1. Create a Twitch account at https://dev.twitch.tv/
+2. Register a new application in the Twitch Developer Console
+3. Note your **Client ID** and generate a **Client Secret**
+
+For detailed instructions, see the [IGDB API documentation](https://api-docs.igdb.com/#account-creation).
+
+## Installation
+
+### Using npx (recommended)
+
+```bash
+npx igdb-mcp-server
+```
+
+### From source
+
+```bash
+git clone https://github.com/yourusername/igdb-mcp-server.git
+cd igdb-mcp-server
+npm install
+npm run build
+```
+
+## Configuration
+
+### Environment Variables
+
+Set the following environment variables:
+
+- `IGDB_CLIENT_ID` - Your Twitch/IGDB Client ID
+- `IGDB_CLIENT_SECRET` - Your Twitch/IGDB Client Secret
+
+### Claude Desktop / Claude Code
+
+Add to your MCP configuration file (`.mcp.json` or `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "igdb": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "igdb-mcp-server"],
+      "env": {
+        "IGDB_CLIENT_ID": "your-client-id",
+        "IGDB_CLIENT_SECRET": "your-client-secret"
+      }
+    }
+  }
+}
+```
+
+Or if running from source:
+
+```json
+{
+  "mcpServers": {
+    "igdb": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/path/to/igdb-mcp-server/dist/index.js"],
+      "env": {
+        "IGDB_CLIENT_ID": "your-client-id",
+        "IGDB_CLIENT_SECRET": "your-client-secret"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### search_games
+
+Search for games in the IGDB database.
+
+**Parameters:**
+- `query` (required): The game name or search query
+- `limit` (optional): Maximum results to return (default: 10, max: 50)
+
+**Example:**
+```
+Search IGDB for "Final Fantasy Tactics"
+```
+
+### get_game_details
+
+Get detailed information about a specific game.
+
+**Parameters:**
+- `game_id` (required): The IGDB game ID
+
+**Example:**
+```
+Get details for IGDB game ID 1920
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+npm start
+
+# Test with MCP Inspector
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+## License
+
+MIT

package/dist/igdb-client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * IGDB API Client with Twitch OAuth2 authentication
+ */
+export interface Game {
+    id: number;
+    name: string;
+    summary?: string;
+    storyline?: string;
+    rating?: number;
+    aggregated_rating?: number;
+    first_release_date?: number;
+    genres?: Array<{
+        id: number;
+        name: string;
+    }>;
+    platforms?: Array<{
+        id: number;
+        name: string;
+    }>;
+    themes?: Array<{
+        id: number;
+        name: string;
+    }>;
+    game_modes?: Array<{
+        id: number;
+        name: string;
+    }>;
+    involved_companies?: Array<{
+        company: {
+            id: number;
+            name: string;
+        };
+    }>;
+    similar_games?: Array<{
+        id: number;
+        name: string;
+    }>;
+    cover?: {
+        url: string;
+    };
+}
+export declare class IGDBClient {
+    private clientId;
+    private clientSecret;
+    private tokenData;
+    constructor();
+    /**
+     * Get a valid OAuth token, refreshing if necessary
+     */
+    private getToken;
+    /**
+     * Make a request to the IGDB API
+     */
+    private request;
+    /**
+     * Search for games by name
+     */
+    searchGames(query: string, limit?: number): Promise<Game[]>;
+    /**
+     * Get detailed information about a specific game
+     */
+    getGameDetails(gameId: number): Promise<Game | null>;
+}
+//# sourceMappingURL=igdb-client.d.ts.map

package/dist/igdb-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"igdb-client.d.ts","sourceRoot":"","sources":["../src/igdb-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACtE,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACzB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAA0B;;IAgB3C;;OAEG;YACW,QAAQ;IAiCtB;;OAEG;YACW,OAAO;IAqBrB;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAcrE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;CAe3D"}

package/dist/igdb-client.js

@@ -0,0 +1,99 @@
+/**
+ * IGDB API Client with Twitch OAuth2 authentication
+ */
+export class IGDBClient {
+    clientId;
+    clientSecret;
+    tokenData = null;
+    constructor() {
+        const clientId = process.env.IGDB_CLIENT_ID;
+        const clientSecret = process.env.IGDB_CLIENT_SECRET;
+        if (!clientId || !clientSecret) {
+            throw new Error("Missing IGDB credentials. Please set IGDB_CLIENT_ID and IGDB_CLIENT_SECRET environment variables.");
+        }
+        this.clientId = clientId;
+        this.clientSecret = clientSecret;
+    }
+    /**
+     * Get a valid OAuth token, refreshing if necessary
+     */
+    async getToken() {
+        // Check if we have a valid token (with 5 minute buffer)
+        if (this.tokenData && Date.now() < this.tokenData.expiresAt - 300000) {
+            return this.tokenData.token;
+        }
+        // Get a new token
+        const url = "https://id.twitch.tv/oauth2/token";
+        const params = new URLSearchParams({
+            client_id: this.clientId,
+            client_secret: this.clientSecret,
+            grant_type: "client_credentials",
+        });
+        const response = await fetch(`${url}?${params}`, {
+            method: "POST",
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Failed to authenticate with Twitch: ${response.status} ${errorText}`);
+        }
+        const data = await response.json();
+        this.tokenData = {
+            token: data.access_token,
+            expiresAt: Date.now() + data.expires_in * 1000,
+        };
+        return this.tokenData.token;
+    }
+    /**
+     * Make a request to the IGDB API
+     */
+    async request(endpoint, body) {
+        const token = await this.getToken();
+        const response = await fetch(`https://api.igdb.com/v4/${endpoint}`, {
+            method: "POST",
+            headers: {
+                "Client-ID": this.clientId,
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "text/plain",
+            },
+            body,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`IGDB API error: ${response.status} ${errorText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Search for games by name
+     */
+    async searchGames(query, limit = 10) {
+        const body = `
+      search "${query.replace(/"/g, '\\"')}";
+      fields name, summary, rating, aggregated_rating,
+             genres.name, platforms.name,
+             first_release_date, cover.url,
+             involved_companies.company.name;
+      limit ${limit};
+    `;
+        const games = await this.request("games", body);
+        return games;
+    }
+    /**
+     * Get detailed information about a specific game
+     */
+    async getGameDetails(gameId) {
+        const body = `
+      where id = ${gameId};
+      fields name, summary, storyline, rating, aggregated_rating,
+             genres.name, themes.name, platforms.name,
+             first_release_date, cover.url,
+             involved_companies.company.name,
+             similar_games.name, similar_games.id,
+             game_modes.name;
+    `;
+        const games = await this.request("games", body);
+        const gameArray = games;
+        return gameArray.length > 0 ? gameArray[0] : null;
+    }
+}
+//# sourceMappingURL=igdb-client.js.map

package/dist/igdb-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * IGDB MCP Server
+ *
+ * A Model Context Protocol server that provides access to the IGDB (Internet Game Database) API.
+ * Supports searching for games and getting detailed game information.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,262 @@
+#!/usr/bin/env node
+/**
+ * IGDB MCP Server
+ *
+ * A Model Context Protocol server that provides access to the IGDB (Internet Game Database) API.
+ * Supports searching for games and getting detailed game information.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { IGDBClient } from "./igdb-client.js";
+// Initialize the IGDB client
+let igdbClient;
+try {
+    igdbClient = new IGDBClient();
+}
+catch (error) {
+    console.error("Error initializing IGDB client:", error);
+    process.exit(1);
+}
+// Create the MCP server
+const server = new Server({
+    name: "igdb-mcp-server",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+/**
+ * Format a game for display
+ */
+function formatGame(game) {
+    const lines = [];
+    lines.push(`**${game.name}** (ID: ${game.id})`);
+    if (game.rating) {
+        lines.push(`Rating: ${game.rating.toFixed(1)}/100`);
+    }
+    if (game.aggregated_rating) {
+        lines.push(`Critic Rating: ${game.aggregated_rating.toFixed(1)}/100`);
+    }
+    if (game.first_release_date) {
+        const date = new Date(game.first_release_date * 1000);
+        lines.push(`Released: ${date.toLocaleDateString()}`);
+    }
+    if (game.genres && game.genres.length > 0) {
+        const genreNames = game.genres.map((g) => g.name).join(", ");
+        lines.push(`Genres: ${genreNames}`);
+    }
+    if (game.platforms && game.platforms.length > 0) {
+        const platformNames = game.platforms.map((p) => p.name).join(", ");
+        lines.push(`Platforms: ${platformNames}`);
+    }
+    if (game.summary) {
+        lines.push(`\nSummary: ${game.summary}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format detailed game information
+ */
+function formatGameDetails(game) {
+    const lines = [];
+    lines.push(`# ${game.name}`);
+    lines.push(`**IGDB ID:** ${game.id}`);
+    lines.push("");
+    if (game.rating) {
+        lines.push(`**User Rating:** ${game.rating.toFixed(1)}/100`);
+    }
+    if (game.aggregated_rating) {
+        lines.push(`**Critic Rating:** ${game.aggregated_rating.toFixed(1)}/100`);
+    }
+    if (game.first_release_date) {
+        const date = new Date(game.first_release_date * 1000);
+        lines.push(`**Released:** ${date.toLocaleDateString()}`);
+    }
+    lines.push("");
+    if (game.genres && game.genres.length > 0) {
+        const genreNames = game.genres.map((g) => g.name).join(", ");
+        lines.push(`**Genres:** ${genreNames}`);
+    }
+    if (game.themes && game.themes.length > 0) {
+        const themeNames = game.themes.map((t) => t.name).join(", ");
+        lines.push(`**Themes:** ${themeNames}`);
+    }
+    if (game.platforms && game.platforms.length > 0) {
+        const platformNames = game.platforms.map((p) => p.name).join(", ");
+        lines.push(`**Platforms:** ${platformNames}`);
+    }
+    if (game.game_modes && game.game_modes.length > 0) {
+        const modeNames = game.game_modes.map((m) => m.name).join(", ");
+        lines.push(`**Game Modes:** ${modeNames}`);
+    }
+    if (game.involved_companies && game.involved_companies.length > 0) {
+        const companyNames = game.involved_companies.map((c) => c.company.name).join(", ");
+        lines.push(`**Companies:** ${companyNames}`);
+    }
+    lines.push("");
+    if (game.summary) {
+        lines.push("## Summary");
+        lines.push(game.summary);
+        lines.push("");
+    }
+    if (game.storyline) {
+        lines.push("## Storyline");
+        lines.push(game.storyline);
+        lines.push("");
+    }
+    if (game.similar_games && game.similar_games.length > 0) {
+        lines.push("## Similar Games");
+        for (const similar of game.similar_games) {
+            lines.push(`- ${similar.name} (ID: ${similar.id})`);
+        }
+    }
+    return lines.join("\n");
+}
+// Register the tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "search_games",
+                description: "Search for games in the IGDB database by name. Returns a list of matching games with basic information including name, rating, genres, platforms, and release date.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "The game name or search query to look for",
+                        },
+                        limit: {
+                            type: "number",
+                            description: "Maximum number of results to return (default: 10, max: 50)",
+                            default: 10,
+                        },
+                    },
+                    required: ["query"],
+                },
+            },
+            {
+                name: "get_game_details",
+                description: "Get detailed information about a specific game by its IGDB ID. Returns comprehensive details including storyline, themes, similar games, and more.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        game_id: {
+                            type: "number",
+                            description: "The IGDB game ID",
+                        },
+                    },
+                    required: ["game_id"],
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        if (name === "search_games") {
+            const query = args?.query;
+            const limit = Math.min(args?.limit || 10, 50);
+            if (!query) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Error: query parameter is required",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const games = await igdbClient.searchGames(query, limit);
+            if (games.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No games found matching "${query}"`,
+                        },
+                    ],
+                };
+            }
+            const formattedGames = games.map(formatGame).join("\n\n---\n\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${games.length} game(s) matching "${query}":\n\n${formattedGames}`,
+                    },
+                ],
+            };
+        }
+        if (name === "get_game_details") {
+            const gameId = args?.game_id;
+            if (!gameId) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Error: game_id parameter is required",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const game = await igdbClient.getGameDetails(gameId);
+            if (!game) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No game found with ID ${gameId}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatGameDetails(game),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Unknown tool: ${name}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("IGDB MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "igdb-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for the IGDB (Internet Game Database) API",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "igdb-mcp-server": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "igdb",
+    "games",
+    "api",
+    "model-context-protocol",
+    "twitch",
+    "game-database",
+    "claude",
+    "ai"
+  ],
+  "author": "tbonderenka",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tbonderenka/igdb-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tbonderenka/igdb-mcp-server/issues"
+  },
+  "homepage": "https://github.com/tbonderenka/igdb-mcp-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}