Gamedb Port

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 3, 2026

IGDB遊戲資料庫：搜尋遊戲、遊戲詳細資訊、預期發行作品以及自訂查詢。

AI 翻譯由 AI 模型根據下方的原文描述翻譯，可能有誤。

原文描述

IGDB game database: search games, game details, anticipated releases, and custom queries.

發布方自己的服務：Port

已驗證STDIO僅桌面資料庫

服務詳細資訊

識別碼: io.github.CloudCorpRecords/gamedb-port
傳輸: STDIO
執行環境: Desktop only
信任: Verified
發布於: Nov 3, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 CloudCorpRecords。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.CloudCorpRecords%2Fgamedb-port.svg)](https://sourceweft.com/mcp/io.github.CloudCorpRecords%2Fgamedb-port?utm_source=readme&utm_medium=badge)

概覽

Gamedb Port 的本機 MCP 服務；無需登入；STDIO。

暫無 AI 概覽：以下資訊來自註冊中心條目和服務本身。

安裝

在 SourceWeft 中

開啟儀表板中的 Gamedb Port，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照儲存庫中的啟動說明。

README

gamedb-port

gamedb-port queries the IGDB video-game database: search games by name, pull the full record for one game, list the most anticipated upcoming releases ranked by hype, or send a raw Apicalypse query to any IGDB endpoint. One binary serves a command-line interface and a stdio MCP server.

Access uses the documented IGDB contract. IGDB is authenticated through Twitch OAuth: set IGDB_CLIENT_ID and IGDB_CLIENT_SECRET to your Twitch application credentials. The tool exchanges them for a client-credentials access token, caches it in-process, and sends it with a Client-ID header on every call. If either variable is missing, commands fail before any request is made.

Install

Or run the container image:

bash

docker run -i -e IGDB_CLIENT_ID=... -e IGDB_CLIENT_SECRET=... ghcr.io/cloudcorprecords/gamedb-port

docker run -i -e IGDB_CLIENT_ID=... -e IGDB_CLIENT_SECRET=... ghcr.io/cloudcorprecords/gamedb-port

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash

gamedb-port search zelda --limit 5gamedb-port search "final fantasy" --fields name,rating --limit 20gamedb-port details 1942gamedb-port details 1942 --fields name,summary,genres.namegamedb-port anticipatedgamedb-port anticipated --limit 10 --min-hypes 50gamedb-port query genres "fields name,slug; limit 5;"
gamedb-port --version

gamedb-port search zelda --limit 5gamedb-port search "final fantasy" --fields name,rating --limit 20gamedb-port details 1942gamedb-port details 1942 --fields name,summary,genres.namegamedb-port anticipatedgamedb-port anticipated --limit 10 --min-hypes 50gamedb-port query genres "fields name,slug; limit 5;"
gamedb-port --version

Commands print the upstream JSON payload. Exit codes: 0 on success, 1 when a call fails (missing credentials, an upstream API error, or invalid argument values), 2 for usage errors.

When no --fields is given, queries request a default field set: name,cover.url,first_release_date,genres.name,platforms.name,rating,summary.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

MCP client configuration:

json

{  "mcpServers": {    "gamedb-port": {      "command": "npx",      "args": ["-y", "@reneturcios/gamedb-port", "mcp"],      "env": {        "IGDB_CLIENT_ID": "your-twitch-client-id",        "IGDB_CLIENT_SECRET": "your-twitch-client-secret"      }    }  }}

{  "mcpServers": {    "gamedb-port": {      "command": "npx",      "args": ["-y", "@reneturcios/gamedb-port", "mcp"],      "env": {        "IGDB_CLIENT_ID": "your-twitch-client-id",        "IGDB_CLIENT_SECRET": "your-twitch-client-secret"      }    }  }}

Tools

Tool	Input	What it returns
`search_games`	`query` (required), `fields`, `limit` (1–500, default 10)	Games matching the name search.
`get_game_details`	`game_id` (required), `fields`	The full IGDB record for one game.
`get_most_anticipated_games`	`fields`, `limit` (1–500, default 25), `min_hypes` (default 25)	Upcoming games with a future release date, sorted by hype descending.
`custom_query`	`endpoint`, `query` (both required)	Whatever the caller's Apicalypse query returns from that endpoint.

The three shaped tools build their Apicalypse bodies for you: search_games becomes search "<query>"; fields ...; limit ...;, get_game_details becomes fields ...; where id = <game_id>;, and get_most_anticipated_games filters first_release_date > now & hypes >= <min_hypes> and sorts by hypes desc. custom_query sends its query body verbatim to https://api.igdb.com/v4/<endpoint>.

Development

bash

npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx

npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx