Skip to main content

GameBanana MCP

Python 3.11+ MCP 1.x

匿名搜索 GameBanana 作品,查看作者署名、前置和归档文件。


✨ 项目简介

这个非官方本地 stdio 服务读取 GameBanana 的公开游戏和 Mod。项目详情保留站点原始 HTML、各尺寸预览图、分组署名与前置说明;文件工具可以查询或下载当前及可访问的归档文件。

⚡ 快速开始

前置条件

  • Python 3.11 或更高版本,以及 uv。
  • 一个支持 stdio 的 MCP 客户端。公开查询和下载使用匿名访问,无需设置 API Key 或 Cookie。

安装与更新

在 gamebanana-mcp 仓库根目录执行:

uv sync --python 3.11

更新仓库源码后,重新执行上面的命令并重启客户端中的服务。若使用已有的 Python 虚拟环境,也可以用 python -m pip install --upgrade . 安装或更新,启动命令为 gamebanana-mcp。

配置客户端

将以下条目加入使用 mcpServers 格式的客户端,把 --directory 后的示例路径替换为本仓库的绝对路径。使用 VS Code 的 .vscode/mcp.json 时,顶层键使用 servers。

{
  "mcpServers": {
    "gamebanana-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "E:/GitHub/mcp/gamebanana-mcp", "run", "--no-sync", "gamebanana-mcp"]
    }
  }
}

第一次调用

试试「在 Baldi’s Basics Plus 中搜索 99 notebooks map,列出作者注明的前置和可下载版本」。客户端可以先调用 search_games 取得游戏 _idRow,再将它作为 game_id 传给 search_mods。

🧰 工具列表

工具 主要参数 用途
list_games 可选 page、per_page 分页浏览游戏目录。
search_games query;可选 page 按关键词查游戏,取得后续筛选用的 _idRow。
browse_mods 可选 game_id、page、per_page 浏览 Mod 目录,或只浏览所选游戏。
search_mods query;可选 game_id、page 在所有游戏或指定游戏内按关键词搜索 Mod。
get_mod mod_id 返回完整 ProfilePage。项目主页见 _sProfileUrl,说明见 _sText,提交者、署名和图集分别见 _aSubmitter、_aCredits、_aPreviewMedia。
get_requirements mod_id 读取 _aRequirements 与 _bAdvancedRequirementsExist,保留纯文字、空链接及作者填写的附加状态。
list_files mod_id 返回 files 列表,记录保留文件名、大小、可用校验值和下载地址;_bIsArchived 标记归档。
get_file mod_id、file_id 按文件 _idRow 取出一条完整元数据,包括可访问的归档记录。
download_file mod_id、file_id 重新查询项目文件列表后下载所选记录,返回本地路径、大小和摘要。

分页。 page 从 1 开始,目录工具接受 per_page(1–50)。关键词搜索的每页大小由站点决定。检查 _aMetadata._bIsComplete 判断是否还有下一页。

本地下载。 默认目录为 ~/Downloads/GameBanana,可在客户端的 env 中设置 GAMEBANANA_DOWNLOAD_DIR 为其他绝对路径。文件按块写入临时文件,核对可用的大小和站点 MD5 后保存。已有同名文件会保留,成功结果含 path、bytes、sha256 和已验证的 md5(如有)。

测试

uv run python -m unittest discover -s tests -v
uv run python tests/smoke_stdio.py

第一条运行离线测试。第二条经真实 stdio 客户端浏览、搜索并读取当前及归档文件元数据,随后匿名下载约 4.5 MB 的样本,在临时目录回读校验。

构建与发布到 PyPI

本地可运行 uv build,在 dist/ 检查 wheel 和源码包。

在 PyPI 为 gamebanana-mcp 配置 GitHub Actions Trusted Publisher:仓库为 GlossMod/gamebanana-mcp(Owner:GlossMod,Repository:gamebanana-mcp),Workflow:publish.yml,Environment:pypi。

在 GitHub 发布带版本标签的 Release(例如 v0.1.1)后,.github/workflows/publish.yml 会使用标签版本构建并检查 wheel 和源码包,通过后自动发布到 PyPI。版本只在 CI 中替换,不会回写仓库。

参考:GameBanana · 项目详情响应示例

Metadata

Release files for gamebanana-mcp 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gamebanana-mcp 1.0.0
File Size Uploaded Provenance Actions
gamebanana_mcp-1.0.0.tar.gz 16.4 kB With provenance Details for gamebanana_mcp-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gamebanana-mcp 1.0.0
File Interpreter ABI Platform Actions
gamebanana_mcp-1.0.0-py3-none-any.whl Python 3 none any Details for gamebanana_mcp-1.0.0-py3-none-any.whl

Total release size: 27.3 kB

Release files / gamebanana_mcp-1.0.0.tar.gz

Download URL gamebanana_mcp-1.0.0.tar.gz
Size 16.4 kB
Tags Source
SHA-256 checksum
How to use checksums
a1cfe6b2c337abd6e7932260da6ddbd80333a708b29745910589707d3cca2e2e
BLAKE2b-256 checksum
How to use checksums
537bb11658304bd6a0df7769f10de92b165ae6587133407235ff09bf7de0be1a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Release files / gamebanana_mcp-1.0.0-py3-none-any.whl

Download URL gamebanana_mcp-1.0.0-py3-none-any.whl
Size 10.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4dc7eb1c5c840960ac9d1e2ea92ca59e7b4bc43e9fa02a17d17becfdc563e4ae
BLAKE2b-256 checksum
How to use checksums
b881e960d124b358f13c12b32bea8140366f32693a982fb7417d59cb19a310f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Security for gamebanana-mcp 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for gamebanana_mcp-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page