DataWorks MCP Server

공식

Model Context Protocol (MCP) 서버로, AI가 표준화된 인터페이스를 통해 DataWorks Open API와 상호작용할 수 있는 도구를 제공합니다. 이 구현은 Aliyun Open API를 기반으로 하며, AI 에이전트가 클라우드 리소스 작업을 원활하게 수행할 수 있도록 지원합니다.

GitHub

문서

DataWorks Agent 사용해 보기

수동 MCP 설정 없이 DataWorks를 위한 즉시 사용 가능한 AI 경험을 원하시나요?

DataWorks Agent 는 데이터 개발 및 운영을 위한 Alibaba Cloud의 내장형 지능형 어시스턴트입니다. DataWorks 작업 공간에 즉시 연결되므로, 자연어를 사용하여 메타데이터 탐색, 노드 개발, 작업 문제 해결, 리소스 관리 등을 로컬 MCP 서버 구성 없이 수행할 수 있습니다.

	DataWorks Agent	이 MCP 서버
적합한 경우	DataWorks 콘솔에서 빠르게 시작	사용자 지정 AI 클라이언트(Cursor, Cline 등)
설정	브라우저에서 열어 사용	설치, AK 구성, MCP 연결
통합	네이티브 DataWorks 경험	MCP 프로토콜을 통한 Open API

👉 시작하기: https://dataworks.data.alibabacloud.com/product/agent?source=github

DataWorks MCP 서버

AI가 표준화된 인터페이스를 통해 DataWorks Open API와 상호 작용할 수 있도록 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. 이 구현은 Aliyun Open API를 기반으로 하며, AI 에이전트가 클라우드 리소스 작업을 원활하게 수행할 수 있도록 합니다.

DataWorks 기능을 자신의 AI 워크플로나 IDE에 포함하려는 경우, 아래 설치 가이드를 따르세요.

개요

이 MCP 서버는:

DataWorks Open API와 상호 작용
DataWorks 리소스 관리

AI 에이전트를 위한 클라우드 리소스 상호 작용을 표준화하기 위해 Model Context Protocol 사양을 구현합니다.

사전 요구 사항

Node.js (v16 이상)
pnpm (권장), npm 또는 yarn
액세스 키와 시크릿 키가 있는 DataWorks Open API

설치

옵션 1: npm에서 설치 (Cursor/Cline과 같은 클라이언트에 권장)

# Install globally
npm install -g alibabacloud-dataworks-mcp-server

# Or install locally in your project
npm install alibabacloud-dataworks-mcp-server

옵션 2: 소스에서 빌드 (개발자용)

이 저장소를 복제합니다:

git clone https://github.com/aliyun/alibabacloud-dataworks-mcp-server
cd alibabacloud-dataworks-mcp-server

종속성을 설치합니다 (pnpm 권장, npm 지원):

pnpm install

프로젝트를 빌드합니다:

pnpm run build

프로젝트를 개발합니다 (@modelcontextprotocol/inspector 사용):

pnpm run dev

http://localhost:5173 열기

구성

MCP 서버 구성

npm을 통해 설치한 경우 (옵션 1):

{
  "mcpServers": {
    "alibabacloud-dataworks-mcp-server": {
      "command": "npx",
      "args": ["alibabacloud-dataworks-mcp-server"],
      "env": {
        "REGION": "your_dataworks_open_api_region_id_here",
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your_alibaba_cloud_access_key_id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your_alibaba_cloud_access_key_secret",
        "TOOL_CATEGORIES": "optional_your_tool_categories_here_ex_UTILS",
        "TOOL_NAMES": "optional_your_tool_names_here_ex_ListProjects"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

소스에서 빌드한 경우 (옵션 2):

{
  "mcpServers": {
    "alibabacloud-dataworks-mcp-server": {
      "command": "node",
      "args": ["/path/to/alibabacloud-dataworks-mcp-server/build/index.js"],
      "env": {
        "REGION": "your_dataworks_open_api_region_id_here",
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your_alibaba_cloud_access_key_id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your_alibaba_cloud_access_key_secret",
        "TOOL_CATEGORIES": "optional_your_tool_categories_here_ex_SERVER_IDE_DEFAULT",
        "TOOL_NAMES": "optional_your_tool_names_here_ex_ListProjects"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

환경 설정

환경에서 변수를 초기화합니다:

# DataWorks Configuration
REGION=your_dataworks_open_api_region_id_here
ALIBABA_CLOUD_ACCESS_KEY_ID=your_alibaba_cloud_access_key_id
ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_alibaba_cloud_access_key_secret
TOOL_CATEGORIES=optional_your_tool_categories_here_ex_SERVER_IDE_DEFAULT
TOOL_NAMES=optional_your_tool_names_here_ex_ListProjects

구성 설명

사용 가이드 설명 링크

프로젝트 구조

alibabacloud-dataworks-mcp-server/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

사용 가능한 도구

MCP 서버는 다음 DataWorks 도구를 제공합니다:

이 링크를 참조하세요

보안 고려 사항

개인 키를 안전하게 보관하고 절대 공유하지 마세요
민감한 정보에는 환경 변수를 사용하세요
AI 에이전트 활동을 정기적으로 모니터링하고 감사하세요

문제 해결

문제가 발생하면:

Aliyun Open API 액세스 키와 시크릿 키가 올바른지 확인하세요
리전 ID가 올바른지 확인하세요
의도한 네트워크(메인넷, 테스트넷, 개발넷)에 있는지 확인하세요
빌드가 성공적으로 완료되었는지 확인하세요

종속성

주요 종속성은 다음과 같습니다:

기여

기여를 환영합니다! Pull Request를 자유롭게 제출해 주세요.

저장소를 포크합니다
기능 브랜치를 만듭니다 (git checkout -b feature/amazing-feature)
변경 사항을 커밋합니다 (git commit -m 'Add some amazing feature')
브랜치에 푸시합니다 (git push origin feature/amazing-feature)
Pull Request를 엽니다

라이선스

이 프로젝트는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다.