Skip to main content
Glama
fscp-mcp

fscp-mcp

by qui364

fscp-mcp

tests

用于读取和编辑 .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 个用于写入。

组

工具

会话

fscp_open, fscp_close, fscp_info

保存

fscp_save, fscp_diff, fscp_revert, fscp_create

设备

list_devices, get_device, search_devices, device_tree, add_device, set_device, move_device, remove_device

ГК 对象

list_objects, get_object, resolve_uid, add_object, set_object, remove_object, add_clause, clear_logic

计划

list_plans, get_plan, find_on_plans, add_plan, set_plan, remove_plan, place_object, remove_placement

底图

list_plan_images, extract_plan_image, get_plan_image

其他

list_drivers, read_xml, export_devices_csv, validate_config

设备可以通过 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 tools
add_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

    C2.8/5.0

    Scored across 38 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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
    • A
      license
      D
      quality
      D
      maintenance
      Enables reading, writing, editing, and converting Office documents (ODT, DOCX, ODS, XLSX, PDF, etc.) using MCP tools, with no external dependencies.
      11
      21 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      2
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Provides 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.
      15
      101 PyPI
      10
      -