DataWorks MCP 서버

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

개요

이 MCP 서버:

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

서버는 AI 에이전트를 위한 클라우드 리소스 상호작용을 표준화하기 위해 모델 컨텍스트 프로토콜 사양을 구현합니다.

필수 조건

Node.js(v16 이상)
pnpm(권장), npm 또는 yarn
액세스 키와 비밀 키가 포함된 DataWorks Open API

설치

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

지엑스피1

옵션 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": []
    }
  }
}

환경 설정

사용자 환경의 init 변수:

# 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가 올바른지 확인하세요
의도한 네트워크(메인넷, 테스트넷 또는 데브넷)에 있는지 확인하세요.
빌드가 성공했는지 확인하세요

종속성

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

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

특허

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

DataWorks MCP Server

Integrations