YepCode 인프라와 AI 플랫폼을 연결하는 MCP (Model Context Protocol) 서버

AI 플랫폼이 YepCode의 인프라와 상호작용할 수 있도록 지원하는 MCP (Model Context Protocol) 서버입니다. LLM (Large Language Model)이 생성한 스크립트를 실행하고, 여러분의 YepCode 프로세스를 AI 어시스턴트가 직접 사용할 수 있는 강력한 도구로 전환하세요. YepCode는 **동적 MCP 도구 서버 (dynamic MCP tools server)**를 구축하기에 완벽한 환경입니다. 각 프로세스를 도구로 노출하고(OAuth, API 토큰 또는 사용자 자격 증명 사용), JSON Schema를 통해 각 도구의 파라미터를 정의하여 완전한 유연성을 확보하며, Python 또는 Node.js로 도구를 구현할 수 있습니다. 이 모든 것이 여러 언어가 혼합된 단일 서버 내에서 이루어집니다.

원활한 AI 통합: 설정 없이 YepCode 프로세스를 AI 준비 완료된 도구로 변환
실시간 프로세스 제어: AI 시스템과 워크플로 간의 직접적인 상호작용 가능
엔터프라이즈급 보안: YepCode의 격리된 프로덕션 준비 환경에서 코드 실행
보편적 호환성: Model Context Protocol을 지원하는 모든 AI 플랫폼과 통합 가능

YepCode는 **동적 MCP 도구 서버 (dynamic MCP tools server)**를 실행하기 위한 이상적인 플랫폼으로 설계되었습니다:

하나의 프로세스, 하나의 도구: 각 YepCode 프로세스는 하나의 MCP 도구로 노출될 수 있습니다. 프로세스에 태그(예: `mcp-tool`, `core`, `automation`)를 지정하면 AI 어시스턴트가 호출할 수 있는 도구가 됩니다. OAuth, API 토큰 또는 기존 YepCode 자격 증명을 사용하여 액세스를 보호할 수 있으며, 각 도구는 동일한 보안 모델을 가진 사용자의 워크스페이스에서 실행됩니다.

도구 파라미터에 대한 완전한 제어: 모든 도구는 JSON Schema로서 자체 파라미터 스키마 (parameter schema)를 정의할 수 있습니다. 입력값(타입, 설명, 필수 필드, 열거형(enums), 기본값 등)을 기술할 수 있는 완전한 유연성을 제공하므로, AI가 풍부한 메타데이터를 수신하고 도구를 정확하게 호출할 수 있습니다.

다국어 도구 구현 (Polyglot tool implementations): 도구를 Python 또는 Node.js(또는 둘 다)로 구현할 수 있습니다. 동일한 MCP 서버가 서로 다른 런타임(runtime)을 기반으로 하는 도구들을 노출할 수 있습니다. 즉, 여러 언어에 걸쳐 구현이 혼합된 하나의 MCP 서버라고 생각하면 됩니다.

전체 문서는 YepCode MCP Server 문서를 참조하세요.

이 패키지를 사용하면 YepCode MCP 서버를 로컬 (locally) 환경 또는 자체 인프라(NPX, Docker 또는 사용자 정의 배포)에서 실행할 수 있습니다. 이를 Cursor 또는 Claude Desktop과 같은 AI 플랫폼과 통합하세요.

팁: YepCode 계정을 통해 로컬 설치가 필요 없는 호스팅된 MCP 서버에도 접근할 수 있습니다. 연결 URL은 항상 다음과 같습니다:
https://cloud.yepcode.io/mcp

YepCode API 자격 증명(credentials) 가져오기:

YepCode Cloud에 가입하세요.
Settings > API credentials를 방문하여 새로운 API 토큰을 생성하세요.

Node.js(버전 18 이상)가 설치되어 있는지 확인하고, 다음과 유사한 설정을 사용하세요:

{
"mcpServers": {
"yepcode-mcp-server": {
...

컨테이너 이미지 빌드:

docker build -t yepcode/mcp-server .

다음과 유사한 설정을 사용하세요:

{
"mcpServers": {
"yepcode-mcp-server": {
...

MCP 서버는 stdio를 통해 통신하기 때문에 디버깅(Debugging)이 까다로울 수 있습니다. 이를 더 쉽게 만들기 위해 MCP Inspector 사용을 권장하며, 다음 명령어로 실행할 수 있습니다:

npm run inspector

이를 통해 브라우저에서 직접 디버깅 도구에 접근할 수 있는 서버가 시작됩니다.

MCP 서버는 YepCode 인프라와 상호작용하기 위한 여러 도구(tools)를 제공합니다:

YepCode의 보안 환경에서 코드를 실행합니다.

// 입력 (Input)
{
code: string; // 실행할 코드
...

YepCode MCP 서버는 다음 옵션들을 지원합니다:

runCodeCleanup
: run_code의 정리(cleanup) 과정을 건너뜁니다. 기본적으로 run_code가 처리한 소스 코드는 실행 후 삭제됩니다. 감사(audit) 목적으로 코드를 유지하고 싶다면 이 옵션을 사용할 수 있습니다.

skipCodingRules
: run_code 도구 정의에 코딩 규칙(coding rules)을 포함하는 것을 건너뜁니다. 기본적으로 AI가 생성하는 코드를 가이드하기 위해 YepCode 문서의 JavaScript 및 Python 코딩 규칙이 도구 스키마(tool schema)에 포함됩니다. 더 빠른 도구 초기화 또는 더 작은 도구 정의를 위해 이를 건너뛰고 싶다면 이 옵션을 사용할 수 있습니다.

옵션은 YEPCODE_MCP_OPTIONS 환경 변수에 쉼표로 구분된 목록으로 전달할 수 있습니다.

YEPCODE_MCP_TOOLS 환경 변수에 도구 카테고리(tool categories)와 프로세스 태그(process tags)를 쉼표로 구분된 목록으로 설정하여 어떤 도구를 활성화할지 제어할 수 있습니다.

내장 도구 카테고리 (Built-in tool categories):

run_code
: 코드 실행 도구 (code execution tool)를 활성화합니다.

yc_api
: 모든 기본 API 관리 도구 (프로세스, 스케줄, 변수, 스토리지, 실행, 모듈)를 활성화합니다.

yc_api_full
: 버전 관련 도구를 포함한 모든 API 관리 도구를 활성화합니다 (yc_api를 확장하여 추가적인 프로세스 및 모듈 버전 관리 도구를 제공합니다).

특정 API 도구 이름 (예: execute_process_sync, get_execution, ...)

프로세스 태그 (Process tags):

YepCode 프로세스에서 사용되는 모든 태그 (예: mcp-tool, core, automation 등)
프로세스 태그를 지정하면, 해당 태그가 지정된 모든 프로세스가 개별 MCP 도구로 노출됩니다.
프로세스 도구는 프로세스 슬러그(slug)를 사용하여 명명됩니다 (이름이 60자보다 길 경우 yc_ 접두사와 프로세스 ID가 붙습니다).

지정하지 않을 경우 모든 내장 도구가 기본적으로 활성화되지만, 프로세스 도구는 노출되지 않습니다.

// 옵션을 포함한 NPX 설정
{
"mcpServers": {
...

예시 시나리오 (Example scenarios):

YEPCODE_MCP_TOOLS=run_code,yc_api

내장 코드 실행 및 기본 API 관리 도구를 활성화합니다.

YEPCODE_MCP_TOOLS=run_code,yc_api_full

내장 코드 실행 및 모든 API 관리 도구 (버전 관리 포함)를 활성화합니다.

YEPCODE_MCP_TOOLS=core,automation

"core" 또는 "automation" 태그가 지정된 프로세스만 도구로 노출합니다.

YEPCODE_MCP_TOOLS=run_code,yc_api,core

내장 도구와 함께 "core" 태그가 지정된 모든 프로세스를 활성화합니다.

YepCode 워크스페이스에 환경 변수를 설정합니다.

// 입력 (Input)
{
key: string; // 변수 이름
...

YepCode 워크스페이스에서 환경 변수를 제거합니다.

// 입력 (Input)
{
key: string; // 제거할 변수의 이름
...

YepCode는 파일을 업로드, 목록 확인, 다운로드 및 삭제할 수 있는 내장 스토리지 시스템을 제공합니다. 이 파일들은 yepcode.storage 헬퍼 메서드 (helper methods)를 사용하여 코드 실행 중에 접근할 수 있습니다.

YepCode 스토리지의 모든 파일 목록을 나열합니다.

// 입력 (Input)
{
prefix?: string; // 파일을 필터링하기 위한 선택적 접두사 (Optional prefix)
...

YepCode 스토리지에 파일을 업로드합니다.

// 입력 (Input)
{
filename: string; // 파일 경로 (예: 'file.txt' 또는 'folder/file.txt')
...

YepCode 스토리지에서 파일을 다운로드합니다.

// 입력 (Input)
{
filename: string; // 다운로드할 파일 경로
...

YepCode 스토리지에서 파일을 삭제합니다.

// 입력 (Input)
{
filename: string; // 삭제할 파일 경로
...

MCP 서버는 YepCode 프로세스 (Processes)를 개별 MCP 도구 (tools)로 노출할 수 있어, AI 어시스턴트가 직접 접근할 수 있게 합니다. 이 기능은 YEPCODE_MCP_TOOLS 환경 변수 (environment variable)에 프로세스 태그 (process tags)를 지정함으로써 활성화됩니다.

작동 방식:

YepCode 프로세스에 원하는 태그를 지정합니다 (예: core, api, automation, mcp-tool 등).
해당 태그들을 YEPCODE_MCP_TOOLS 환경 변수에 추가합니다.
지정된 태그를 가진 모든 프로세스가 개별 MCP 도구로 노출됩니다.

노출된 각 프로세스에 대해 프로세스 슬러그 (process slug)를 이름으로 사용하는 도구가 생성됩니다 (도구 이름이 60자를 초과하는 경우 yc_ 접두사와 프로세스 ID가 붙습니다).

프로세스 태그에 대한 자세한 내용은 프로세스 태그 문서(process tags documentation)를 참조하세요.

// 입력 (Input)
{
parameters?: any; // 이는 프로세스에 지정된 입력 파라미터 (input parameters)와 일치해야 합니다
...

API 관리 도구 카테고리(yc_api 및 yc_api_full)는 YepCode 워크스페이스 (workspace)의 모든 측면을 관리할 수 있는 포괄적인 API 접근을 제공합니다.

기본 API 도구 (yc_api):
yc_api 태그는 워크스페이스 전반의 핵심 작업을 위한 표준 API 관리 도구를 활성화합니다.

확장 API 도구 (yc_api_full):
yc_api_full 태그는 yc_api의 모든 기능을 포함하며, 프로세스 및 모듈 버전을 관리하기 위한 추가 도구를 제공합니다.

프로세스 관리 (Processes Management):

get_processes

선택적 필터링을 포함한 프로세스 목록 조회 create_process
소스 코드를 사용하여 새로운 프로세스 생성 get_process
프로세스 상세 정보 조회 update_process
기존 프로세스 업데이트 delete_process
프로세스 삭제 get_process_versions
프로세스 버전 조회 (yc_api_full 권한 필요) execute_process_async
프로세스를 비동기적으로 실행 execute_process_sync
프로세스를 동기적으로 실행 schedule_process
프로세스를 자동으로 실행하도록 예약

스케줄 관리 (Schedules Management):

get_schedules

예약된 프로세스 목록 조회 get_schedule
스케줄 상세 정보 조회 pause_schedule
예약된 프로세스 일시 중지 resume_schedule
일시 중지된 스케줄 재개 delete_schedule
스케줄 삭제 update_schedule
예약된 프로세스 업데이트

변수 관리 (Variables Management):

get_variables

팀 변수 목록 조회 create_variable
새로운 변수 생성 update_variable
기존 변수 업데이트 delete_variable
변수 삭제

스토리지 관리 (Storage Management):

get_storage_objects

스토리지 객체 목록 조회 upload_storage_object
스토리지에 파일 업로드 download_storage_object
스토리지에서 파일 다운로드 delete_storage_object
스토리지에서 파일 삭제

실행 관리 (Executions Management):

get_executions

선택적 필터링을 포함한 실행 목록 조회 get_execution
API로부터 실행 상세 정보 조회 kill_execution
실행 중인 프로세스 강제 종료 rerun_execution
이전 실행 재실행 get_execution_logs
실행 로그 조회

모듈 관리 (Modules Management):

get_modules

스크립트 라이브러리 모듈 목록 조회 create_module
새로운 모듈 생성 get_module
모듈 상세 정보 조회 delete_module
모듈 삭제 get_module_versions
모듈 버전 조회 (yc_api_full 권한 필요) get_module_version
특정 모듈 버전 조회 (yc_api_full 권한 필요) delete_module_version
모듈 버전 삭제 (yc_api_full 권한 필요) get_module_aliases
모듈 버전 별칭(Alias) 조회 (yc_api_full 권한 필요)

이 프로젝트는 MIT License 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하십시오.

YepCode 인프라와 AI 플랫폼을 연결하는 MCP (Model Context Protocol) 서버

요약

핵심 포인트

댓글