1C: Platform Tools MCP

MCP 서버는 Cursor 또는 VS Code 에이전트에게 1C: Platform Tools 확장의 명령(테스트, 실행 프로필, 구성 빌드, 데이터베이스 작업)에 대한 액세스를 제공합니다.

설치

1. 1C: Platform Tools 설치: Marketplace, Open VSX

2. 1C: Platform Tools MCP 설치: Marketplace, Open VSX

3. 1C 프로젝트(packagedef가 있는 폴더)를 엽니다.

Related MCP server: 1C_MCP_SERVER_OWN

연결

VS Code는 추가 작업이 필요하지 않습니다. 확장이 MCP 서버를 자체 등록합니다.

Cursor는 VS Code MCP 서버 제공자를 지원하지 않으므로, 서버는 프로젝트의 .cursor/mcp.json을 통해 연결됩니다. 이 파일은 확장이 생성하고 업데이트합니다:

1. 명령 팔레트(F1) → 1C: Platform Tools MCP: Cursor용 MCP 설정, 또는 1C 도구 트리 → AI 기술 → Cursor용 MCP 설정.

2. 창을 다시 로드합니다.

3. MCP 설정에서 mcp-1c-platform-tools 서버를 활성화합니다. Cursor는 새 서버를 비활성화된 상태로 추가합니다.

명령은 서버 경로와 IPC 매개변수를 기록하며, 파일의 다른 서버는 유지됩니다. 경로에는 확장 버전이 포함되므로, 업데이트 후 항목이 오래되어 서버가 MODULE_NOT_FOUND 오류로 중단됩니다. 확장은 시작 시 이를 수정합니다. 즉, 경로가 동일한 확장의 다른 설치를 가리키는 경우 경로를 업데이트합니다. 수동으로 입력된 경로(예: 소스에서 빌드한 경우)는 그대로 유지됩니다.

확인

에이전트에게 "1C 환경 상태 보여줘"라고 요청하세요. 응답에는 활성 실행 프로필, 플랫폼 버전 및 데이터베이스 경로가 포함됩니다. 그 후에는 테스트 실행, 프로필 전환, 구성 빌드를 요청할 수 있습니다.

문서

• 에이전트에게 요청할 내용

• 도구 매개변수

수동 설정

확장 없이 구성을 설정하는 경우에만 필요합니다. 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)도 동일하게 작동하지만, 확장이 이를 업데이트하지 않습니다. 여러 프로젝트의 경우 프로젝트 파일이 더 안정적입니다.