vladimir-kharin/1c_mcp

Инструмент для создания MCP-серверов в 1С:Предприятие путем разработки расширения конфигурации. Позволяет интегрировать данные и функциональность 1С с AI-ассистентами (Claude, Cursor и т.д.). Включает Python-прокси и пример расширения 1С с готовыми инструментами.

是什么

vladimir-kharin/1c_mcp 是一个开源工具包，允许俄罗斯ERP平台 1С:Предприятие 的开发者通过 Model Context Protocol (MCP) 向大型语言模型（LLM）暴露其数据和业务逻辑。它提供了一个现成的1С扩展，实现MCP服务器端，以及一个可选的Python代理，用于处理认证、传输转换和Docker部署。

为何重要

LLM（ChatGPT、Claude、Cursor等）在能够查询最新、领域特定信息时表现最佳。MCP是一种新兴的开放标准，允许模型在运行时发现工具并请求数据。该项目弥合了1С专有数据模型与该协议之间的差距，使任何MCP兼容的AI客户端都能使用基于1С的知识。

核心组件

组件	功能	语言 / 运行时
`src/1c_ext/`	实现MCP HTTP服务的1С扩展（`MCP_Сервер.cfe`），注册工具容器，并提供操作1С元数据的辅助函数。	1С（BSL）
`src/py_server/`	位于AI客户端与1С HTTP服务之间的可选Python代理。支持OAuth2，可转发用户级Basic Auth，并将基于`stdio`的传输转换为HTTP。	Python（Docker就绪）

快速入门（概览）

安装1С扩展 – 将编译后的 build/MCP_Сервер.cfe 复制到您的1С配置中，并发布HTTP服务 mcp_APIBackend。
暴露服务 – 确保URL中包含精确的数据库名称（区分大小写），以避免导致POST请求失败的重定向。
连接AI客户端 – 将Cursor、Claude Desktop或任何MCP兼容工具指向 …/your_db/hs/mcp/。示例客户端配置位于 mcp_client_settings/。
(推荐) 运行Python代理 – 参考 src/py_server/ 中的README，或通过Docker启动（docker-compose up -d）。代理处理OAuth2并可转发每个用户的凭据，因此无需禁用1С认证。

如何添加自定义功能

创建新的1С处理程序，并将其添加到子系统 mcp_КонтейнерыИнструментов 中。

实现两个导出方法：

Процедура ДобавитьИнструменты(Инструменты) Экспорт
    // 描述工具名称、参数等
КонецПроцедуры

Функция ВыполнитьИнструмент(ИмяИнструмента, Аргументы) Экспорт
    // 由LLM调用的实际业务逻辑
КонецФункции

或者，将您的工具打包到一个独立的1С扩展中，该扩展也包含一个名为 *_mcp_MCPСервер 的子系统——服务器将自动发现它。
使用 src/1c_ext/agents.md 中的指南了解详细的API语义，可选择性地公开 Resources（静态文件）或 Prompts（模板消息）。

典型用例

AI辅助ERP支持 – 聊天助手可让模型获取客户订单历史、计算税额或即时创建新发票。
代码生成辅助 – LLM可从1С请求模式信息，生成正确的BSL代码片段。
商业智能 – 代理可检索聚合指标、运行自定义报告或通过MCP工具触发后台任务。

文档与资源

Python代理：src/py_server/README.md
1С扩展详情：src/1c_ext/README.md
工具开发指南：src/1c_ext/agents.md
示例客户端配置：mcp_client_settings/
视频概览：README中的VK、YouTube、Rutube链接

许可证

MIT – 您可以自由使用、修改和重新分发代码。

TL;DR: 此仓库提供了一个现成的1C MCP服务器和一个Python代理，使任何MCP兼容的LLM客户端都能调用自定义的1С工具并自动获取企业数据。它是主流俄罗斯ERP系统与现代AI助手之间的一座具体桥梁。