Tank Fight MCP — 游戏规范即服务

一个 MCP 服务器，提供 Tank Fight 的权威规范：场地和窗口大小、坦克和子弹属性、生成规则、计分、控制、菜单行为、AI 策略、难度曲线，以及每个关卡的可破坏迷宫。

它作为本地服务运行在一个端口上。任何 MCP 客户端都可以连接，询问它提供哪些工具，并查询规范 — 无论你是用 Java、TypeScript 还是其他任何语言构建游戏。

它的用途

两项工作，第二项比乍看起来更重要。

1. 让独立的实现保持一致。 同一款游戏的两个独立构建，一旦需要一个没人记录下来的数字，就会开始分叉。让两者都向同一个服务询问坦克有多大，就消除了猜测。

2. 阻止模型凭空发明需求。 规范中遗漏的每个细节，都是 AI 编码助手悄悄挑一个看似合理的选项然后继续的地方 — 子弹会停在墙边吗？友军能互相射击吗？玩家在回合中途被摧毁会发生什么？ 它很少提及自己做了决定。这些问题在这里都有答案，于是问题变成了查表而不是猜测，而 open_questions 会指出真正尚未决定的内容，因此诚实的答案是“问人类”，而不是自信的编造。

Related MCP server: OWASP Pentest Guide Knowledge Base

运行它

需要 uv。

uv sync

uv run server.py

该服务在 http://127.0.0.1:8082/mcp 提供规范。使用 --port 在其他端口监听，使用 --host 绑定其他接口，使用 --stdio 用于只支持 stdio 的客户端。

连接客户端

任何 MCP 客户端，可以同时连接任意数量。对于 Claude Code：

claude mcp add --transport http tank-spec http://localhost:8082/mcp

添加 --scope project 将其记录在你正在构建的仓库中，这样参与该构建的每个人都能获得相同的规范。然后使用 /mcp 确认连接，客户端就可以询问服务器存在哪些工具以及如何调用它们 — 这里不需要为每个客户端进行任何配置。

工具

这个服务器刻意不做的事

它不知道谁连接了它，也不知道他们在构建什么，这是有意为之。它了解规范；客户端了解服务器。没有任何反向的指向。

因此，检查实现是否仍然符合规范是客户端的工作。客户端可以从自己的代码中读取这些值，并将它们与这些工具返回的内容进行比较 — 客户端就在那个仓库中，而服务器不在。一个服务器如果要深入检出目录去检查实现，就必须知道语言、文件布局和路径，并且每次出现另一个实现时都需要更新。

同样的理由也解释了为什么规范是以服务形式提供，而不是作为文件分发：

• 它在每个实现之外。 在一个仓库中工作的会话无法读取另一个仓库的文件，但它可以调用服务。

• 它是被查询的，而不是被倾倒的。 search_spec("friendly fire") 返回一条规则。把整个规范加载到模型的上下文中来回答一个问题，正是这种方法要避免的浪费。

• 有些答案是计算出来的，而不是存储的。 关卡由难度曲线公式生成 — 第 6 关不存在于任何文件中。resolve_level 是唯一正确的询问方式，其整数截断至关重要：浮点版本在八个关卡中的四个上会产生分歧。

可破坏砖块与每关迷宫

边界内的所有东西都是砖块，砖块可以被射掉 — 双方都可以，因为阵营对坦克有意义，对墙壁则毫无意义。一个瓦片是 20x20，承受 40 点伤害，所以两发标准子弹就能打开一个洞，坦克随后可以驶过。边界本身免疫伤害。

每个关卡都有自己的迷宫，因此关卡编号是唯一的难度旋钮：它决定有多少敌人到达、到达速度，以及他们到达的地形。第 1 关几乎开阔；第 8 关密集到通常射出一条路比找到一条路更快。

get_maze(level) 返回矩形、展开后的瓦片列表，以及一张图片：

########################################
#EE................EE................EE#
#EE................EE................EE#
#......................................#
#......BBBBBBBBBBB....BBBBBBBBBBB......#
...
#.............AA...AA...AA.............#
########################################

使用展开后的瓦片，而不是自己展开矩形 — 这一步，以及子弹横跨两个瓦片时伤害哪个瓦片的规则，正是两个构建最容易从同样的射击中挖出不同洞的地方。

添加一个迷宫只需在 YAML 的 mazes.levels 下添加矩形。测试套件随后会使其满足让关卡可玩的各项不变量：与瓦片对齐、在区域内、不重叠、出生点和友军框畅通，并且每个入口点都可以在不摧毁任何东西的情况下步行到达 — 挖掘是捷径，绝不是必需。

编辑规范

spec/game-spec.yaml 就是全部内容，而且它本意就是手工编辑 — 这正是重点。服务器在每次调用时都会重新读取它，因此更改会立即生效，无需重启任何东西。

该规范最初来自一个可工作的实现，并从此独立于该实现。它起引领作用：先在这里更改一个值，然后让各个实现跟随。

测试

uv run pytest

tests/test_spec.py 固定规范中的值，并让每个迷宫都满足可玩性不变量。tests/test_server.py 通过 MCP 客户端驱动服务器 — 发现工具、读取其描述、调用它们。tests/test_http.py 在端口上启动真实进程，并通过 HTTP 连接到它，就像客户端所做的那样。

目录结构

spec/game-spec.yaml   the specification — the actual source of truth
server.py             MCP server: tool definitions, their descriptions, and the transport
tank_spec/spec.py     loading, searching, level maths, maze expansion
tests/                spec and maze invariants, MCP integration, HTTP transport