一个用于源引擎地图工作的MCP服务器。它读取.vmf和.bsp文件，将地图与之对照 游戏自有的FGD，编辑.vmf而不重格式化，修补已编译地图的实体 无需重新编译，则以 Wine 驱动编译器 — Hammer++ 默认使用，按需存储或 作为备选方案——并测量一张地图 违背了格式的限制。

**它从不和运行中的引擎通信。**它读写文件，运行编译器，什么都不做 否则。这正是它能不锁、能放在在线服务器旁边而不打扰它的原因。

测量日期为2026年11月8日。工具返回JSON;条形图是该README对该文件的渲染。每条 上面的数字在那个JSON里，docs/measuring.md也说明了这些内容 每一个。

它的作用

hammer-mcp

An MCP server for Source-engine map work. It reads .vmf and .bsp files, lints a map against the game’s own FGD, edits a .vmf without reformatting it, patches a compiled map’s entities without recompiling, drives the compilers under Wine — Hammer++ by default, stock on demand or as a fallback — and measures a map against the limits of the format.

It never talks to a running engine. It reads and writes files and runs compilers, and nothing else. That is what lets it hold no lock and sit beside a live server without disturbing it.

> read_map_geometry rp_nycity_day.bsp

  a 1.13 GB map — header and lump directory only, 1 ms

  MODELS       1218 /  1024   119%  ████████████▏  over
  TEXINFO     11841 / 12288    96%  █████████▋
  VERTEXES    62270 / 65536    95%  █████████▌
  BRUSHES      6913 /  8192    84%  ████████▍

  4 lumps at or past 80% of their ceiling.

  MODELS is past it outright — and this map loads every day. That is
  not a broken map: it is evidence that the compilers which built it
  raise that ceiling. The tool reports it in those terms, rather than
  an error it cannot substantiate.

Measured on 11/08/2026. The tool returns JSON; the bars are this README’s rendering of it. Every number above is in that JSON, and docs/measuring.md says what corroborates each one.

What it does

flowchart LR
  VMF[".vmf"] --> LINT["read_vmf_lintagainst the game's FGD"]
  LINT --> EDIT["edit_vmfsplice, never reserialise"]
  EDIT --> VMF
  LINT --> C["vbsp · vvis · vradunder Wine"]
  C --> BSP[".bsp"]
  BSP --> M["measure · pack · patch entities"]
  M -. never .-x ENG["a running engine"]
  style ENG stroke-dasharray: 4 4