vladimir-kharin/1c_mcp

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

무엇인가요

vladimir-kharin/1c_mcp 는 러시아 ERP 플랫폼 1С:Предприятие 개발자를 위한 오픈소스 툴킷으로, 대규모 언어 모델(LLM)이 Model Context Protocol (MCP) 를 통해 데이터와 비즈니스 로직을 노출할 수 있게 해줍니다. 미리 준비된 1C 확장 프로그램과 인증 처리, 전송 변환, Docker 배포를 지원하는 선택적 Python 프록시를 제공합니다.

왜 중요한가요

LLM(ChatGPT, Claude, Cursor 등)은 최신이고 도메인 특화된 정보를 쿼리할 수 있을 때 가장 잘 작동합니다. MCP는 실행 시 런타임에서 도구를 발견하고 그 도구를 통해 데이터를 요청할 수 있도록 해주는 등장 중인 오픈 표준입니다. 이 프로젝트는 1C의 고유 데이터 모델과 이 프로토콜 사이의 격차를 메우며, 모든 MCP 호환 AI 클라이언트가 1C 기반 지식을 사용할 수 있도록 합니다.

핵심 구성 요소

구성 요소	기능	언어 / 런타임
`src/1c_ext/`	MCP HTTP 서비스를 구현하고, 도구 컨테이너를 등록하며, 1C 메타데이터 작업을 위한 헬퍼 함수를 제공하는 1C 확장(`MCP_Сервер.cfe`)입니다.	1C (BSL)
`src/py_server/`	AI 클라이언트와 1C HTTP 서비스 사이에 위치하는 선택적 Python 프록시입니다. OAuth2 지원을 추가하고, 사용자별 Basic Auth를 전달할 수 있으며, `stdio` 기반 전송을 HTTP로 변환합니다.	Python (Docker 대응)

빠른 시작 (개요)

1C 확장 설치 – 컴파일된 build/MCP_Сервер.cfe 를 1C 구성에 복사하고 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를 처리하고 각 사용자의 자격 증명을 전달할 수 있어 1C 인증을 비활성화할 필요가 없습니다.

사용자 정의 기능 추가 방법

새로운 1C 처리 생성 후 mcp_КонтейнерыИнструментов 서브시스템에 추가합니다.

두 개의 내보내기 메서드를 구현합니다:

Процедура ДобавитьИнструменты(Инструменты) Экспорт
    // 도구 이름, 매개변수 등을 설명
КонецПроцедуры

Функция ВыполнитьИнструмент(ИмяИнструмента, Аргументы) Экспорт
    // LLM이 호출할 실제 비즈니스 로직
КонецФункции

또는 도구를 별도의 1C 확장 프로그램에 패키징하고 *_mcp_MCPСервер 라는 이름의 서브시스템을 포함시킵니다. 서버는 자동으로 이를 탐지합니다.
src/1c_ext/agents.md 의 가이드를 사용해 API 의미를 자세히 확인하고, 선택적으로 Resources(정적 파일) 또는 Prompts(템플릿 메시지)를 공개할 수 있습니다.

일반적인 사용 사례

AI 지원 ERP 지원 – 챗 어시스턴트가 모델에 고객의 주문 이력 조회, 세금 계산, 즉시 새로운 청구서 생성을 요청할 수 있습니다.
코드 생성 지원 – LLM이 1C에서 스키마 정보를 요청하여 올바른 BSL 스니펫을 생성할 수 있습니다.
비즈니스 인텔리전스 – 에이전트는 집계된 메트릭을 검색하고, 사용자 정의 리포트를 실행하거나 MCP 도구를 통해 백그라운드 작업을 트리거할 수 있습니다.

문서 및 리소스

Python 프록시: src/py_server/README.md
1C 확장 세부 정보: 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 클라이언트가 사용자 정의 1C 기반 도구를 호출하고 기업 데이터를 자동으로 가져올 수 있도록 합니다. 이는 주류 러시아 ERP 시스템과 현대 AI 어시스턴트 사이의 구체적인 다리입니다.