HB

hby7921/bannerlordsage

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

22 stars 4 forks 质量 63 趋势 24MIT

一个用于《骑马与砍杀II:霸主》的模型上下文协议(MCP)服务器。赋予AI代理反编译源代码搜索、XML数据浏览、游戏游戏操作查询、本地模组源索引和补丁等权限。

概览

一个MCP服务器提供源代码搜索和数据浏览。 本地编辑器创作目前已在对齐的Bannerlord游戏和模组套件中验证。预制布局、场景保存和视口捕获已测试;地形编辑、可玩任务、导航和航行尚未验证。提交PR或报告问题。 它读取本地 Bannerlord 安装,导入 XML,反编译官方 DLL,构建 SQLite 索引,并公开 AI 编码代理的 MCP 工具。使用场景: - 模组开发 - 逆向工程 - 结构化游戏游戏查找 - 读取本地模组源代码 要让编码代理(Codex、Claude、Gemini、Copilot等)帮你安装和配置: 1. 将仓库URL发送给AI;2.告诉它读取前 AGENTS.md 3.告诉它遵循AI_QUICKSTART.md 4.被要求时提供你的信息 BannerlordSage包含Vortex从RimSage衍生的作品。该项目仍处于MIT许可协议下。参见许可。

概述(AI 翻译)

英文 |简体中文

这是一个为《骑马与砍杀II:霸主》提供源代码搜索和数据浏览功能的MCP服务器。

Editor MCP 是实验性测试版本——欢迎 PR! 本地编辑器创作目前已在对齐的 Bannerlord 游戏和 Modding Kit v1.4.8* 上验证。预制版布局、场景保存和视口捕获已测试;地形编辑、可玩任务、导航和航海尚未验证。提交 PR 或报告问题。

它读取本地 Bannerlord 安装,导入 XML,反编译官方 DLL,构建 SQLite 索引,并公开 AI 编码代理的 MCP 工具。使用场景:

  • 模组开发
  • 逆向工程
  • 结构化游戏查找
  • 读取本地模组源代码

人工智能辅助安装

要让编码代理(Codex、Claude、Gemini、Copilot等)帮你安装和配置:

  1. 将仓库网址发送给 AI
  2. 先让它读 AGENTS.md
  3. 让它跟随AI_QUICKSTART.md
  4. 在被要求时提供你的

署名

BannerlordSage包含了Vortex从RimSage衍生的作品。 该项目仍处于MIT许可下。参见LICENSE。

工具概述

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

BannerlordSage

English | 简体中文

An MCP server for Mount & Blade II: Bannerlord that provides source code search and data browsing.

Editor MCP is an experimental test version — PRs welcome! Local editor authoring is currently validated against an aligned Bannerlord game and Modding Kit v1.4.8. Prefab layout, scene saving and viewport capture have been tested; terrain editing, playable Missions, navigation and sailing are not yet validated. Submit a PR or report an issue.

It reads your local Bannerlord installation, imports XML, decompiles official DLLs, builds a SQLite index, and exposes MCP tools for AI coding agents. Use cases:

  • Mod development
  • Reverse engineering
  • Structured gameplay lookups
  • Reading local mod source code

AI-Assisted Install

To have a coding agent (Codex, Claude, Gemini, Copilot, etc.) install and configure this for you:

  1. Send the repository URL to the AI
  2. Tell it to read AGENTS.md first
  3. Tell it to follow AI_QUICKSTART.md
  4. Provide your `` when asked

Attribution

BannerlordSage includes work derived from RimSage by Vortex. The project remains under the MIT License. See LICENSE.

Tool Overview

BannerlordSage provides 43 tools across two entrypoints:

Entrypoint Tools Notes
bun run start:bannerlord 36 Query, analysis, mod-source work, project memory and experimental editor status
bun run start:bannerlord:full 43 Adds workspace creation, XSLT patch generation and experimental editor authoring

Basic workflow: run setup → start MCP → let the model call tools

Tool List

Diagnostics

Tool Description
bannerlord_doctor Check module health: missing dependencies, duplicate DLLs, load order issues
bannerlord_index_status Check whether BannerlordSage is initialized and the local index is ready

Local Editor — Experimental

Tool Description
bannerlord_editor_status Check local bridge configuration, installed version alignment and the active scene
bannerlord_editor_entities ⁺ Read managed object IDs, prefabs, GUIDs and complete transforms
bannerlord_editor_prefab_info ⁺ Check a prefab and optional mesh bounds in the running editor
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →