fscp-mcp
fscp-mcp
用于读取和编辑 .fscp 配置的 MCP 服务器——即“鲁别日-全球”(Windows Global Monitor)消防保护系统的配置文件。
真实对象的配置是 25 MB 的 XML、512 千行和 5656 个没有名称的设备:只有 GUID、DriverUID 和 IntAddress。既无法整体打开,也无法有意义地 grep。服务器只解析一次归档,并以可寻址的页面回答:“КАУ 1.2 上有什么”、“84ee9eae-… 是什么对象”、“ЛИФТЫ 场景的逻辑是什么”、“显示计划底图”。
编辑——添加设备、绑定区域、在计划上绘制对象——会累积在打开会话的内存中;只有显式的 fscp_save 才会将它们写入磁盘,而且它总是写入新文件。原始配置永远不会被覆盖。fscp_create 从零开始构建配置。
安装
需要 Python 3.11 或更高版本。一条命令即可安装——无需克隆仓库:
uv tool install "git+https://github.com/qui364/fscp-mcp"没有 uv 时,pipx install "git+https://github.com/qui364/fscp-mcp" 也能完成同样的事情,而在普通环境中则使用 pip install "git+https://github.com/qui364/fscp-mcp"。安装后会出现 fscp-mcp 命令——这就是服务器,它通过 stdio 通信,不是手动启动,而是由客户端启动。
Extra img(Pillow)仅用于底图的内联预览——没有它,除 get_plan_image 之外的所有功能都能正常工作:
uv tool install "fscp-mcp[img] @ git+https://github.com/qui364/fscp-mcp"Claude Desktop
设置 → 开发者 → 编辑配置会打开 claude_desktop_config.json(Windows:%APPDATA%\Claude,macOS:~/Library/Application Support/Claude)。将服务器添加到其中,并保留文件中已有的内容:
{
"mcpServers": {
"fscp": {
"command": "fscp-mcp",
"env": { "PYTHONUTF8": "1", "PYTHONIOENCODING": "utf-8" }
}
}
}如果 fscp-mcp 对应用程序不可见(Windows 上常见:GUI 有自己的 PATH),请指定其完整路径——uv tool list 或 pipx list 会显示其安装位置。env 不是装饰性的:没有它,Windows 控制台会输出 cp1251,响应中的西里尔字母会变成乱码。
然后重启 Claude Desktop——服务器会出现在新聊天中。
Claude Code
在克隆的仓库中,服务器会自动启动:配置位于 .mcp.json 中。要使其在任何项目中都可用,请全局注册:
claude mcp add fscp --scope user -- fscp-mcp开发
py -3 -m venv .venv.venv/Scripts/python.exe -m pip install -e ".[dev,img]".venv/Scripts/python.exe -m pytest -q在 Windows 下,PATH 中通常有一个来自 WindowsApps 的 python 占位符——它不起作用,请使用显式路径调用解释器。
Related MCP server: mcp-office-parser
入门
告诉模型要打开哪个文件,之后它就会根据 handle 工作:
打开 C:\Конфигурации\объект.fscp 并显示 КАУ 1.2 上有什么
对于编辑,同样如此,但要指定保存结果的位置:
在 АЛС 1.2.1 上添加 ИП 212-149 探测器,并保存为 объект-правка.fscp
值得了解:SecurityConfiguration.xml(用户密码哈希)服务器根本不会打开——无论是读取还是写入:它会以不透明字节的方式转移到新文件中。结果最好在 Global Monitor 本身中打开——服务器不会检查这一点。
测试
基础测试除了仓库之外不需要任何东西:它们的配置在 tests/factories.py 中即时生成——一个 ZIP,包含与真实文件相同的条目和相同的 XmlSerializer 输出。
真实配置不会发布——其中包含对象数据和带有密码哈希的 SecurityConfiguration.xml。如果它们存在于本地,请指定目录,然后会添加地址与计划上签名的核对(阈值 93%)、25 MB 解析速度检查、过时签名检测器以及序列化器的逐字节检查:每个工作配置的每个 XML 条目都会被解析并写回,结果必须与原始文件逐字节一致——这就是 fscp_save 不会破坏未触及内容的保证:
FSCP_TEST_CONFIGS=<каталог с .fscp> .venv/Scripts/python.exe -m pytest -q工具
37 个工具:20 个用于读取,17 个用于写入。
组 | 工具 |
会话 |
|
保存 |
|
设备 |
|
ГК 对象 |
|
计划 |
|
底图 |
|
其他 |
|
设备可以通过 UID 或 1.2.1.1 形式的地址来寻址。
记录模型
编辑会进入打开的会话,在调用 fscp_save 之前不会写入磁盘——而它总是写入新文件:即使故意也无法覆盖原始文件。编辑未触及的归档条目会连同其元数据(包括 Content/* 中 blob 自己的时间戳)逐字节复制到新文件中——在 25 MB 配置中“添加一个探测器”的编辑只会改变文件中的几千字节,而不是整个文件。
fscp_diff 用俄语显示会话中累积的内容。fscp_revert 一次性回滚到打开时的状态。在写入之前,fscp_save 会运行完整性检查(check=false 可禁用),如果发现违规则拒绝:UID 重复、地址冲突、没有单一目标的逻辑条件、字段顺序与 XmlSerializer 自身写入的顺序不一致。
只能创建其模式已从工作配置中提取的对象类型——目前是设备、区域和场景。方向、МПТ、安防区域、门和 СКД 区域在所有可用配置中都是空的:可以编辑和删除它们,但不能创建——猜测的结构会静默破坏文件。
.fscp 内部结构
ZIP,包含来自 .NET XmlSerializer 的 XML,以及 Content/ 中的计划底图。覆盖范围包括 GKDeviceConfiguration.xml、PlansConfiguration.xml 和 Content/*。SecurityConfiguration.xml 不会被读取——其中包含用户密码哈希。
格式的详细解析、地址计算规则和包架构见 CLAUDE.md。
完整性检查
validate_config 会发现在 Global Monitor 本身中不可见的缺陷:
计划上的过时签名——对象签名在绘制时被缓存,在 АЛС 重新编号后会显示错误的地址(在工作配置中,每个文件最多可发现 215 个);
类型名称不一致——
drivers.json参考手册与应用程序之间的差异;悬空的计划对象、损坏的底图引用以及
Content/中的孤儿。
Available Tools
38 toolsadd_clauseB
Добавить условие в логику устройства или объекта. group — OnClausesGroup, OffClausesGroup, OnNowClausesGroup, OffNowClausesGroup или StopClausesGroup. state принимается кодом (Fire2) или по-русски (Пожар2). Список для целей и название операции выбираются по виду целей; every=true даёт «во всех» вместо «в любом из».
Inputs: owner (required), handle (required), targets (required), tag, +4 more. Returns: object
add_deviceB
Добавить устройство под указанный узел дерева. driver — короткое имя из list_drivers или UID драйвера. Без int_address берётся первый свободный адрес на линии. count>1 добавляет несколько подряд.
Inputs: driver (required), handle (required), parent (required), count, +2 more. Returns: object
add_objectA
Создать объект верхнего уровня: zone (зона) или scenario (сценарий). Номер No назначается автоматически — следующий свободный. Виды, для которых схема не снята с рабочих конфигураций, создать нельзя.
Inputs: kind (required), name (required), handle (required), fields, +1 more. Returns: object
add_planB
Создать план. parent_uid вкладывает его в другой план. image_path — картинка PNG или JPEG с диска: она кладётся в Content/ архива, а размеры плана берутся из её заголовка.
Inputs: name (required), handle (required), width, height, +3 more. Returns: object
clear_logicA
Убрать логику: указанную группу условий целиком либо, без group, все группы владельца.
Inputs: owner (required), handle (required), tag, group. Returns: object
device_treeC
Компактное текстовое дерево устройств с потолком по глубине и узлам.
Inputs: handle (required), root, max_depth, max_nodes. Returns: object
export_devices_csvC
Выгрузить плоский список устройств в CSV по указанному пути вне архива.
Inputs: handle (required), out_path (required). Returns: object
extract_plan_imageC
Выгрузить подложку плана в файл на диск (вне архива) для просмотра.
Inputs: guid (required), handle (required), out_path (required). Returns: object
find_on_plansA
На каких планах нарисован объект с данным UID.
Inputs: uid (required), handle (required). Returns: object
fscp_closeC
Закрыть архив и освободить память сессии.
Inputs: handle (required). Returns: object
fscp_createB
Создать новую пустую конфигурацию .fscp и сразу открыть её — вернётся handle. donor — путь к существующему .fscp, из которого побайтово переносится SecurityConfiguration.xml (учётные записи): сервер его не разбирает и не показывает. Без донора запись просто отсутствует, и пользователей заводят в самом Global Monitor — примет ли он такой файл, не проверено.
Inputs: path (required), donor, overwrite. Returns: object
fscp_diffB
Что накоплено в сессии: список правок по-русски и какие записи архива будут перезаписаны при сохранении.
Inputs: handle (required), limit, offset. Returns: object
fscp_infoC
Сводка по открытому архиву: версии, счётчики, список ГК, записи ZIP.
Inputs: handle (required). Returns: object
fscp_openC
Открыть файл .fscp и получить handle для остальных вызовов.
Inputs: path (required). Returns: object
fscp_revertA
Откатить все правки сессии к состоянию на момент открытия архива. Частичный откат не поддерживается.
Inputs: handle (required). Returns: object
fscp_saveA
Сохранить конфигурацию с правками в НОВЫЙ файл .fscp. Исходник не трогается никогда; существующий файл по пути out_path перезаписывается только при overwrite=true. Записи, которых правка не касалась, копируются побайтово. Перед записью идёт проверка целостности — отключается через check=false.
Inputs: handle (required), out_path (required), check, overwrite. Returns: object
get_deviceC
Полная карточка устройства по UID или адресу вида 1.2.1.1.
Inputs: device (required), handle (required). Returns: object
get_objectC
Карточка объекта верхнего уровня (зона, сценарий, направление) по UID.
Inputs: uid (required), handle (required). Returns: object
get_planD
План со списком нарисованных на нём объектов (страницами).
Inputs: handle (required), plan_uid (required), limit, offset. Returns: object
get_plan_imageC
Инлайновое превью подложки. Требует установленной Pillow (pip install -e .[img]); max_px обязателен — оригиналы бывают 5000x4749.
Inputs: guid (required), handle (required), max_px.
list_devicesC
Дети узла дерева устройств. Без parent — корень конфигурации.
Inputs: handle (required), limit, driver, offset, +1 more. Returns: object
list_driversC
Справочник драйверов Рубеж; query фильтрует по имени, описанию, категории.
Inputs: limit, query, handle, offset. Returns: object
list_objectsD
Объекты верхнего уровня: zone, guard_zone, scenario, direction, mpt, door и др.
Inputs: handle (required), kind, limit, query, +1 more. Returns: object
list_plan_imagesC
Подложки планов из Content/: размер, разрешение, кто ссылается, сироты.
Inputs: handle (required). Returns: object
list_plansC
Дерево планов с числом объектов на каждом.
Inputs: handle (required). Returns: object
move_deviceA
Перенести устройство вместе с поддеревом под другой узел — например, перевесить прибор на другую АЛС. Без int_address адрес выбирается свободный на новой линии.
Inputs: device (required), handle (required), new_parent (required), int_address. Returns: object
place_objectA
Нарисовать объект ГК на плане. Устройства кладутся точкой (left, top), зоны и сценарии — прямоугольником (нужны ещё width и height). Связь ставится с обеих сторон.
Inputs: item (required), handle (required), plan_uid (required), top, +3 more. Returns: object
read_xmlA
Сырой фрагмент XML по пути ElementTree (например Zones/GKZone[1]). Запасной путь, когда типизированных инструментов не хватает.
Inputs: path (required), handle (required), config, max_chars. Returns: object
remove_deviceA
Удалить устройство вместе с поддеревом. Если на него ссылаются зоны, логика или объекты на планах, вызов отказывает и перечисляет ссылки; force=true удаляет вместе с ними.
Inputs: device (required), handle (required), force. Returns: object
remove_objectB
Удалить зону или сценарий, вычистив ссылки на него: привязки устройств, условия логики, объекты на планах. Без force отказывает и перечисляет, кто ссылается.
Inputs: uid (required), handle (required), force. Returns: object
remove_placementC
Убрать объект с плана, сняв связь с обеих сторон.
Inputs: item (required), handle (required), plan_uid (required). Returns: object
remove_planB
Удалить план вместе с вложенными в него и всеми нарисованными объектами. Без force отказывает, если удалять есть что.
Inputs: handle (required), plan_uid (required), force. Returns: object
resolve_uidC
Что за объект скрывается за GUID: устройство, зона, план, подложка, драйвер.
Inputs: uid (required), handle (required). Returns: object
search_devicesC
Поиск устройств по типу (короткое имя драйвера), префиксу адреса, описанию или значению свойства.
Inputs: handle (required), limit, driver, offset, +4 more. Returns: object
set_deviceA
Изменить поля устройства: описание, IntAddress, отключение, серийный номер, привязку к зонам, свойства GKProperty. Задавайте только то, что меняете. Подписи на планах обновляются сами.
Inputs: device (required), handle (required), zones, serial_no, +4 more. Returns: object
set_objectC
Изменить поля объекта: имя, описание, Fire1Count/Fire2Count у зоны, DelayTime/Hold/DelayRegime у сценария. Номер No не меняется никогда — он входит в отображаемое имя и на него ссылаются.
Inputs: uid (required), handle (required), name, fields, +1 more. Returns: object
set_planB
Изменить имя, описание или размеры плана.
Inputs: handle (required), plan_uid (required), name, width, +2 more. Returns: object
validate_configC
Проверка целостности: устаревшие подписи на планах, битые ссылки на подложки и объекты, сироты в Content/.
Inputs: handle (required), limit. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 38 tools
Each tool has a distinct purpose: archive operations (fscp_*), device CRUD, object management, plan editing, logic clauses, and utilities. Even similar actions like remove_plan vs remove_placement vs remove_device are clearly separated by resource type. No two tools appear to do the same thing.
Most tools follow a verb_noun pattern (list_devices, add_device, set_device, remove_device). However, there are deviations: the fscp_ prefix for archive operations (fscp_create, fscp_open, fscp_save) vs. plain add_/set_ for entities, plus a few unique names (device_tree, resolve_uid, read_xml). While readable, the mixed conventions prevent a perfect score.
38 tools exceeds the 25+ threshold for 'too many'. The server covers a broad domain (devices, objects, plans, logic, archives), but the sheer number may overwhelm an agent, and some tools could be consolidated (e.g., plan image tools). The count feels excessive for typical MCP servers, even with this scope.
The surface covers the main lifecycle: create/read/update/delete for devices, objects, and plans, plus logic management and archive operations. There are minor gaps—no raw XML write capability (only read_xml as fallback), no editing of SecurityConfiguration, and no bulk import beyond CSV export—but these are workable or intentional shortcuts.
Related MCP Connectors
Read, analyze, and safely edit Microsoft Project MPP files.
Browse, search, upload, tag, transfer, and delete images in your Raster libraries over MCP.
Read and edit the Revit 2024–2027 model on your PC. Needs the free Revit MCP add-in.
Unofficial Archive MCP — wraps the Internet Archive APIs (free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA local MCP server that provides tools for working with 7-Zip archives, enabling archive creation, extraction, item management, and file system operations through a standardized interface.MIT
- AlicenseDqualityDmaintenanceEnables reading, writing, editing, and converting Office documents (ODT, DOCX, ODS, XLSX, PDF, etc.) using MCP tools, with no external dependencies.1121 npmMIT
- AlicenseAqualityDmaintenanceMCP server that enables searching and reading binary document files (PDF, DOCX, PPTX, XLSX, ODT, ODS, ODP, RTF, EPUB) using regex patterns and retrieving content by sections.2MIT
- FlicenseAqualityBmaintenanceProvides read-only analysis of Mitsubishi GX Works3 PLC projects via MCP, enabling device tracing, cross-referencing, ladder inspection, linting, and report generation without modifying source projects.15101 PyPI10-