1C:Enterprise용 INFATON MCP 서버

Name: INFATON MCP35
Author: infaton

MCP35 MCP server

Model Context Protocol (MCP) — AI 어시스턴트가 1C 데이터베이스와 상호 작용할 수 있도록 35가지 도구를 제공하는 1C:Enterprise 측 서버입니다.

프로토콜: JSON-RPC 2.0 (MCP 사양)

📋 저장소 구성

파일	설명
`Module.bsl`	MCP HTTP 서비스 모듈 — 35가지 도구의 핵심 코드
`INFATON_MCP.cfe`	1C 구성 확장(준비된 바이너리 패키지)
`HOW_TO_BUILD_CFE.md`	`.cfe` 빌드 및 설치 지침

🛠 35가지 도구

메타데이터 (8)

#	도구	설명
1	`get_metadata_tree`	구성 메타데이터 객체 트리
2	`get_object_metadata`	객체의 전체 구조 (속성, 테이블 섹션, 모듈)
3	`get_object_attributes`	객체 속성 목록
4	`get_object_tabular_sections`	객체 테이블 섹션
5	`get_enum_values`	열거형 값
6	`get_register_dimensions`	레지스터의 차원, 리소스 및 속성
7	`get_document_movements`	레지스터에 대한 문서 이동
8	`search_metadata`	메타데이터 검색 (이름/동의어 기준)

데이터 (7)

#	도구	설명
9	`execute_query`	임의의 1C 쿼리 실행
10	`get_object_by_ref`	참조/GUID를 통한 객체 가져오기
11	`get_list`	필터가 적용된 참조/문서 항목 목록
12	`find_by_code`	코드로 검색
13	`find_by_name`	이름으로 검색
14	`get_register_records`	필터가 적용된 레지스터 레코드
15	`get_document_list`	날짜/번호 필터가 적용된 문서 목록

CRUD (7)

#	도구	설명
16	`create_object`	새 객체 생성 (참조/문서)
17	`update_object`	객체 속성 수정
18	`delete_object`	삭제 표시
19	`post_document`	문서 게시
20	`unpost_document`	게시 취소
21	`copy_object`	객체 복사
22	`set_attribute`	개별 속성 수정

코드 및 계산 (3)

#	도구	설명
23	`execute_code`	임의의 1C 코드 실행
24	`evaluate_expression`	표현식 평가
25	`get_module_text`	객체 모듈 텍스트 가져오기

보고서 (1)

#	도구	설명
26	`generate_report`	보고서 생성 (DCS)

관리 (4)

#	도구	설명
27	`get_active_users`	활성 사용자 목록
28	`get_event_log`	이벤트 로그
29	`get_locks`	데이터 잠금
30	`get_server_info`	1C 서버 정보

검사 및 제어 (2)

#	도구	설명
31	`check_references`	참조 무결성 검사
32	`run_scheduled_job`	예약된 작업 실행

데이터 교환 (3)

#	도구	설명
33	`exchange_execute`	데이터 교환 실행
34	`get_exchange_log`	교환 로그
35	`import_data`	JSON에서 데이터 가져오기

🚀 빠른 시작

1. 확장 설치

1C 데이터베이스의 **구성기(Configurator)**를 엽니다.
구성(Configuration) → 구성 확장(Configuration extensions) → 추가(Add)
INFATON_MCP.cfe 파일을 선택합니다.
DB 구성을 업데이트합니다 (F7).

2. 확인

curl -u 'Логин:Пароль' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1}' \
  https://ваш-сервер/база/hs/mcp/

예상 응답:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": { "tools": {} },
    "serverInfo": { "name": "infaton-1c-mcp", "version": "1.0.0" }
  }
}

3. 도구 호출

curl -u 'Логин:Пароль' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,"params":{"name":"get_metadata_tree","arguments":{}}}' \
  https://ваш-сервер/база/hs/mcp/

📐 아키텍처

┌─────────────────────────┐
│   AI Assistant          │  Claude / GPT / Qwen / ...
│   (MCP Client)          │
└────────┬────────────────┘
         │ JSON-RPC 2.0
         ▼
┌─────────────────────────┐
│   HTTP-сервис /hs/mcp/  │  Расширение INFATON_MCP.cfe
│   Module.bsl            │  35 инструментов
│   (MCP Server)          │
└────────┬────────────────┘
         │ Встроенный язык 1С
         ▼
┌─────────────────────────┐
│   База 1С:Предприятие   │  ERP / УПП / Бухгалтерия / ...
│   Данные, метаданные    │
└─────────────────────────┘

📝 호환성

1C 플랫폼: 8.3.20+ (8.3.27에서 테스트됨)
구성: ERP 2.5, UPP 1.3, Accounting 3.0, UT 11, KA 2
MCP 프로토콜: 2024-11-05
전송: HTTP (Basic Auth)

📄 라이선스

.cfe 빌드에 대한 자세한 지침은 HOW_TO_BUILD_CFE.md를 참조하십시오.

Install Server

A

license - permissive license

A

quality

B

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Resources

GitHub Repository

Need Help?

Related Servers

Tools

View all tools

INFATON MCP35