ESA MCP 서버

ESA MCP 서버는 AI 모델과 ESA(Edge Security Acceleration) 서비스 간의 통신을 원활하게 하도록 설계된 모델 컨텍스트 프로토콜(MCP) 서버의 구현입니다. 이 서버는 표준화된 프로토콜을 통해 모델이 ESA 기능을 활용할 수 있도록 하는 브리지 역할을 합니다.

영어 | 중국어

설치

MCP 지원 클라이언트 구성에서 다음을 구성합니다.

지엑스피1

데모 영상

클로드 데모

클라인 데모

Cline이 성공적으로 구성되었습니다:

Claude가 성공적으로 구성되었습니다:

특징

도구 실행을 위한 모델 컨텍스트 프로토콜을 구현합니다.
ESA OpenAPI 서비스에 대한 액세스를 제공합니다.
모델 러너와의 원활한 통합을 위해 stdio를 통해 서버로 실행됩니다.

도구 목록

서버는 MCP 프로토콜을 통해 호출 가능한 다음 ESA 도구를 제공합니다.

일상 관리 도구

루틴 생성

루틴을 만드세요

매개변수	유형	필수의	설명
이름	끈	예	루틴 이름은 소문자, 숫자, 하이픈을 지원하며 소문자로 시작해야 하며 최소 2자여야 합니다.
설명	끈	아니요	일상적인 설명, 공백은 허용되지 않습니다.
암호	끈	예	루틴 소스 코드, 예: `export default { async fetch(request) { return handleRequest(request); } }`

루틴 삭제

루틴 삭제

매개변수	유형	필수의	설명
이름	끈	예	삭제할 루틴의 이름

루틴_리스트

모든 루틴 나열

매개변수가 필요하지 않습니다.

루틴_겟

일상 세부 정보 가져오기

매개변수	유형	필수의	설명
이름	끈	예	쿼리할 루틴의 이름

배포 도구

루틴_코드_커밋

커밋 루틴 코드

매개변수	유형	필수의	설명
이름	끈	예	루틴 이름
암호	끈	예	루틴 소스 코드

루틴_코드_배포

루틴 코드 배포

매개변수	유형	필수의	설명
이름	끈	예	루틴 이름
코드 버전	끈	예	루틴 버전은 유효한 semver이어야 합니다.
환경	끈	예	일상 환경: "생산" 또는 "스테이징"
카나리아 지역 목록	정렬	아니요	Canary 릴리스 영역은 유효한 영역 이름이어야 합니다(canary_area_list 참조)
canaryCodeVersion	끈	아니요	Canary 버전은 유효한 semver여야 합니다.

카나리아_지역_목록

정기 배포에 사용 가능한 모든 카나리아 지역을 나열하세요.

매개변수가 필요하지 않습니다.

배포 삭제

배포 삭제

매개변수	유형	필수의	설명
이름	끈	예	배포 이름

경로 관리 도구

경로 생성

루틴에 대한 경로 생성

매개변수	유형	필수의	설명
사이트 ID	숫자	예	사이트 ID
방법	끈	예	경로 모드: '간단' 또는 '사용자 지정'
노선	끈	모드에 필요함	경로 경로(모드가 '단순'인 경우 필수)
규칙	끈	예	경로 규칙(모드가 '사용자 지정'인 경우 필수)
루틴 이름	끈	예	루틴 이름
경로 이름	끈	예	경로 이름
우회로	끈	예	바이패스: '켜짐' 또는 '꺼짐'(기본값은 '꺼짐')
경로 활성화	끈	예	활성화: '켜기' 또는 '끄기'(기본값은 '켜기')
순서	숫자	아니요	경로 순서(기본값: 현재 개수)

경로 업데이트

루틴 경로 업데이트

매개변수	유형	필수의	설명
사이트 ID	숫자	예	사이트 ID
구성 ID	숫자	예	구성 ID
경로 이름	끈	예	경로 이름
경로 활성화	끈	예	활성화: '켜기' 또는 '끄기'
규칙	끈	예	경로 규칙
루틴 이름	끈	예	루틴 이름
우회로	끈	예	바이패스: '켜짐' 또는 '꺼짐'
순서	숫자	아니요	경로 순서

경로 삭제

루틴 경로 삭제

매개변수	유형	필수의	설명
사이트 ID	숫자	예	사이트 ID
구성 ID	숫자	예	구성 ID

경로_get

루틴 관련 경로 가져오기

매개변수	유형	필수의	설명
사이트 ID	숫자	예	사이트 ID
구성 ID	숫자	예	구성 ID

루틴_경로_목록

루틴의 모든 경로를 나열합니다

매개변수	유형	필수의	설명
루틴 이름	끈	예	루틴 이름
경로 이름	끈	아니요	목록 결과를 필터링하는 데 사용되는 경로 이름
페이지 번호	숫자	아니요	경로 페이지 번호
페이지 크기	숫자	아니요	페이지당 경로

사이트 경로 목록

사이트의 모든 경로를 나열합니다

매개변수	유형	필수의	설명
사이트 ID	숫자	예	사이트 ID
경로 이름	끈	아니요	목록 결과를 필터링하는 데 사용되는 경로 이름
페이지 번호	숫자	아니요	경로 페이지 번호
페이지 크기	숫자	아니요	페이지당 경로

기록 관리 도구

er_record_create

레코드를 생성하세요

매개변수	유형	필수의	설명
이름	끈	예	루틴의 이름
사이트 ID	숫자	예	사이트의 ID
레코드 이름	끈	예	레코드의 이름

er_record_delete

레코드 삭제

매개변수	유형	필수의	설명
이름	끈	예	루틴의 이름
사이트 ID	숫자	예	사이트의 ID
레코드 이름	끈	예	레코드의 이름
레코드 ID	숫자	아니요	레코드의 ID

er_record_list

모든 레코드 나열

매개변수	유형	필수의	설명
이름	끈	예	루틴의 이름
페이지 번호	숫자	아니요	레코드의 페이지 번호
페이지 크기	숫자	아니요	레코드의 페이지 크기
검색키워드	끈	아니요	검색어

사이트 도구

사이트 활성 목록

모든 활성 사이트 나열

매개변수가 필요하지 않습니다.

사이트 매치

사용자 입력과 일치하는 계정의 어떤 사이트를 확인하세요

매개변수	유형	필수의	설명
레코드 이름	끈	예	일치시킬 사이트의 이름

사이트_DNS_유형_a_레코드_생성

사이트에 대한 A 레코드 만들기

매개변수	유형	필수의	설명
레코드 이름	끈	예	DNS 레코드의 이름(예: 하위 도메인 또는 전체 도메인)
사이트 ID	숫자	예	ListSites 작업에서 얻은 사이트의 ID
데이터	물체	예	값 속성이 있는 DNS 레코드의 데이터
데이터.값	끈	예	A 레코드의 IP 주소(예: "2.2.2.2")

사이트_DNS_CNAME_도메인_레코드_생성

사이트에 대한 CNAME 도메인 레코드 만들기

매개변수	유형	필수의	설명
레코드 이름	끈	예	DNS 레코드의 이름(예: 하위 도메인 또는 전체 도메인)
사이트 ID	숫자	예	ListSites 작업에서 얻은 사이트의 ID
데이터	물체	예	값 속성이 있는 DNS 레코드의 데이터
데이터.값	끈	예	CNAME 레코드의 도메인 값

사이트_레코드_목록

사이트의 모든 레코드 나열

매개변수	유형	필수의	설명
사이트 ID	숫자	예	ListSites 작업에서 얻은 사이트의 ID

사용 가능한 스크립트

npm run build - rslib을 사용하여 프로젝트 빌드
npm run dev - 개발을 위해 watch 모드로 빌드 실행
npm run format - Prettier를 사용하여 코드 포맷하기
npm run lint - ESLint를 사용하여 코드 확인

프로젝트 구조

src/index.ts - 주요 진입점
src/tools/ - ESA 도구 구현
src/utils/ - 유틸리티 및 도우미

특허

아이에스씨

기여

Alibaba 내부 기여자의 경우 프로젝트의 표준 기여 워크플로를 따르세요.