GameBanana MCP
✨ 项目简介
这个非官方本地 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.