关于 mcp-1c-platform-tools
mcp-1c-platform-tools 是 1C: Platform Tools 扩展的 MCP 服务,让 VS Code 或 Cursor 中的 AI 代理访问 1C 配置、1C:EDT 与 OneScript 项目的命令。它面向 1C 开发者,需要先安装并启用 IPC 已开启的 1C: Platform Tools 扩展。
主要功能
- 01运行测试并查看结果
- 02切换运行配置(启动profile)
- 03查询 1C 环境状态与平台版本
- 04执行配置构建与数据库相关操作
- 05支持为 Cursor 自动生成项目 MCP 配置
适用场景
- 01让 AI 代理在 VS Code 或 Cursor 中运行 1C 项目测试
- 02通过自然语言切换启动配置并检查数据库路径
- 03在多个项目之间维护 Cursor 的项目级 MCP 配置
MCP 相关
该项目是 MCP 服务,向 VS Code 或 Cursor 中的 AI 代理提供 1C: Platform Tools 扩展的命令,通过 IPC 与扩展通信。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y mcp-1c-platform-toolsONEC_IPC_PORTПорт IPC-сервера расширения 1c-platform-tools (настройка 1c-platform-tools.ipc.port)ONEC_IPC_TOKEN密钥Токен IPC (если задан в 1c-platform-tools.ipc.token)本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
1C: Platform Tools MCP
MCP 服务让 VS Code 或 Cursor 中的 Agent 能够在配置器、1C:EDT 和 OneScript 项目中使用 1C: Platform Tools 扩展的命令:测试、启动配置文件、配置构建、数据库操作。
安装
- 安装 1C: Platform Tools:Marketplace、Open VSX
- 安装 1C: Platform Tools MCP:Marketplace、Open VSX
- 打开 1C 项目(包含
packagedef的文件夹)。
连接
VS Code 无需其他操作:扩展会自行注册 MCP 服务。
Cursor 不支持 VS Code 的 MCP 服务提供程序,因此需要通过项目的 .cursor/mcp.json 连接服务。此文件由扩展创建和更新:
- 命令面板(F1)→
1C: Platform Tools MCP: Настроить MCP для Cursor,或在 Инструменты 1С 树中选择 Навыки для AI → Настроить MCP для Cursor。 - 重新加载窗口。
- 在 MCP 设置中启用
mcp-1c-platform-tools服务:Cursor 新增的服务默认处于关闭状态。
命令会写入服务路径和 IPC 参数;文件中的其他服务会保留。路径中包含扩展版本,因此更新后配置会过时,服务会因 MODULE_NOT_FOUND 而崩溃。扩展会在启动时修复此问题:如果路径指向同一扩展的其他安装位置,就会更新路径。手动指定的路径(例如指向源码构建版本)会保持不变。
检查
向 Agent 发送“显示 1C 环境状态”。回复中会包含当前的启动配置文件、平台版本和数据库路径。之后可以要求运行测试、切换配置文件、构建配置。
文档
docs 目录发布在 1C: Platform Tools 网站的 MCP 服务页面中:安装和连接、工具参数、可以向 Agent 发送什么。
手动配置
仅在不通过扩展创建配置时才需要。必须启用 1c-platform-tools.ipc.enabled 设置,ONEC_IPC_* 的值取自 1c-platform-tools.ipc.*:
{
"mcpServers": {
"mcp-1c-platform-tools": {
"command": "node",
"args": ["<путь к каталогу расширения>/out/src/index.js"],
"env": {
"ONEC_IPC_HOST": "127.0.0.1",
"ONEC_IPC_PORT": "40241",
"ONEC_IPC_TOKEN": ""
}
}
}
}
扩展目录:%USERPROFILE%\.cursor\extensions\yellow-hammer.mcp-1c-platform-tools-<версия>-universal(Windows)或 ~/.cursor/extensions/...(macOS、Linux)。每次扩展更新后,都必须手动修改此路径。
全局配置(%USERPROFILE%\.cursor\mcp.json)的工作方式相同,但扩展不会更新它:若用于多个项目,项目级文件更可靠。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。


