Bannerlord Sage

BannerlordSage

   

英语 | 简体中文

MCP服务器 《山与剑II：旗手》 它提供源代码搜索和数据浏览。

它读取您本地的Bannerlord安装，导入XML，反编译官方DLL，构建SQLite索引，并为AI编码代理公开MCP工具。使用案例：

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

AI辅助安装

要为您安装和配置编码代理（Codex、Claude、Gemini、Copilot等），请执行以下操作：

1. 将存储库URL发送给AI
2. 让它读 AGENTS.md 第一
3. 让它跟着 AI_QUICKSTART.md
4. 提供您的 `` 当被问及

归因

BannerlordSage包括Vortex从RimSage衍生的作品。 该项目仍在MIT许可证下。看 LICENSE.

工具概述

BannerlordSage提供 34工具 跨越两个入口点：

基本工作流程： 运行安装程序→ 启动MCP→ 让模型调用工具

刀具清单

诊断

项目记忆

官方来源和XML

结构化游戏查找

本地Mod源

这些工具读取您自己的本地mod源代码，而不是官方导入的源代码。

补丁和代码生成

⁺ 仅适用于 start:bannerlord:full.

常见工作流

浏览官方来源：

1. search_source --查找文件
2. read_file --阅读相关章节
3. read_csharp_type --检查类型定义

浏览XML或本地化：

1. search_xml --查找文件
2. read_file --阅读内容
3. resolve_localization --解析令牌

已知游戏ID，直接查找：

• 直接使用结构化查询工具： get_item_stats, trace_troop_tree, get_hero_profile等等。

读取本地mod源代码：

1. mod_source_status --确认工作空间
2. search_mod_source --搜索代码
3. read_mod_file / read_mod_type --阅读详细信息

使用项目记忆恢复工作：

1. project_memory_wakeup --加载工作区的关键活动上下文
2. project_memory_search --检查是否已经存在类似的决定、陷阱或偏好
3. project_memory_capture_session --在任务结束时存储有用的会话输出

每日MCP使用情况

一旦BannerlordSage安装并连接到您的AI客户端，正常的日常循环是：

1. 启动或恢复任务并呼叫 project_memory_wakeup
2. 探索官方行为 search_source, read_file，以及 read_csharp_type
3. 探索你自己的模组 mod_source_status, search_mod_source, read_mod_file，以及 read_mod_type
4. 当你已经知道游戏id时，使用结构化查询工具
5. 在陈述项目历史之前，请致电 project_memory_search
6. 任务接近尾声时，呼叫 project_memory_capture_session

项目内存工作流

项目记忆是一个局部回忆层。它不会改变模型的上下文窗口。它为代理提供了一个存储决策、陷阱、偏好和后续状态的地方。

这样使用它：

• 使用以下命令启动已恢复的任务 project_memory_wakeup
• 在声明项目历史记录之前搜索内存
• 仅存储持久结论
• 更喜欢 project_memory_capture_session 接近任务完成
• 当旧记忆不再真实时，使其失效

安装

1.先决条件

• 视窗
• 合法拥有的当地Bannerlord装置
• 包子
• ripgrep
• .NET SDK 8+
• ILSpyCmd

安装所有依赖项的一行代码：

powershell -c "irm bun.sh/install.ps1 | iex"
winget install BurntSushi.ripgrep.MSVC
winget install Microsoft.DotNet.SDK.8
dotnet tool install --global ilspycmd

2.安装软件包

bun install

3.运行安装程序

bun run setup:bannerlord -- --game-dir ""

替换 `` 使用本地Bannerlord安装的绝对路径。第一次跑步需要一段时间；后续运行是递增的。

常见标志：

4.启动MCP

# Default (recommended)
bun run start:bannerlord

# Full toolset
bun run start:bannerlord:full

MCP客户端配置

[mcp_servers.bannerlordsage]
command = "bun"
args = ["run", "src/entrypoints/bannerlord-stdio.ts"]
cwd = ""
enabled = true

完整的工具集：

[mcp_servers.bannerlordsage]
command = "bun"
args = ["run", "src/entrypoints/bannerlord-full-stdio.ts"]
cwd = ""
enabled = true

替换 `` 在您的计算机上具有此存储库的绝对路径。

环境变量

脚本

bun run setup:bannerlord -- --game-dir ""   # initialize / update index
bun run start:bannerlord                                         # start default MCP
bun run start:bannerlord:full                                    # start full MCP
bun run verify:memory                                            # verify native project-memory tools
bun run index:gameplay                                           # rebuild gameplay index only
bun run index:mod-source -- --source-dir ""     # index local mod source
bun run verify:bannerlord -- --game-dir "" # local regression check
bun run smoke:release                                            # quick build validation
bun run report:scopes -- --game-dir ""     # output scope report

项目结构

免责声明

该项目旨在通过合法拥有的游戏副本进行个人学习、研究和模组开发。

1. 该存储库不包括或重新分发Bannerlord游戏资产。
2. 用户有责任遵守游戏EULA和适用的当地法律。
3. 默认情况下，已解压缩和索引的内容仍然是本地的。