1C Templates MCP Server

MCP模板服务器1C

MCP服务器用于存储和搜索BSL代码模板。模板管理-通过BSL控制台（1C语法突出显示）的Web界面。

发射

run.bat

脚本收集Docker映像并运行映射容器 data/templates/ 的主机。

或手动：

docker build -t mcp-templates .
docker run -d --name mcp-templates -p 8023:8023 \
  -v "$(pwd)/data/templates:/app/data/templates" \
  -e TEMPLATES_DIR=/app/data/templates \
  --restart unless-stopped mcp-templates

Web接口

在浏览器中打开： http://localhost:8023

• 搜索模板列表（按名称、描述、标签）
• 在BSL控制台中创建和编辑模板（1C语法突出显示）
• 删除模板

使用Cursor/Claude Code

服务器使用传输 可流式传输的HTTP在MCP设置中，指定：

{
  "mcpServers": {
    "1c-templates": {
      "type": "streamableHttp",
      "url": "http://localhost:8023/mcp"
    }
  }
}

MCP工具

工具描述 |---|---| | list_templates() 列出所有模板（ID，name，description，tags）！ | get_template(template_id) 完整的ID模板 | search_templates(query) –搜索标题、描述和标签中的子字符串→

搜索是模糊的：忽略寄存器和y/e；对于超过4个字符的单词，前缀搜索（查找格式化）。

Cursor中的使用示例

在聊天中，写下：

找到Excel模板并将代码粘贴到当前模块中

Cursor将通过MCP调用 search_templates("excel")，将获得模板ID，然后 get_template(id) -并返回BSL代码。

模板存储

模板存储在 data/templates/ （Docker Volume，数据在重新编译时保存）：

• index.json 所有模板的元数据（ID，名称，描述，标签）
• .bsl -每个模板的BSL代码

手动添加模板

创建文件 data/templates/my_template.bsl 代码，而 index.json 添加条目：

{
  "my_template": {
    "id": "my_template",
    "name": "Мой шаблон",
    "description": "Описание",
    "tags": ["тег1", "тег2"]
  }
}

新 .bsl-未写入文件 index.json 下一次访问列表时自动捕获。

项目结构

.
├── Dockerfile
├── run.bat              # Сборка и запуск контейнера
├── app/
│   ├── main.py          # HTTP-сервер + MCP (stdlib Python, без зависимостей)
│   └── storage.py       # CRUD: index.json + .bsl файлы
└── data/
    └── templates/       # Шаблоны (volume, ~30 шаблонов в комплекте)
        ├── index.json
        └── *.bsl

服务器是用纯STDLib Python编写的，没有PIP、虚拟环境或第三方软件包。