workers-mcp

Claude Desktop의 Cloudflare 직원과 대화해보세요!

[!경고]
대신 여기에서 시작해야 합니다. 원격 MCP 서버를 구축하세요.

mcp-remote를 사용하면 Claude Desktop, Cursor 및 기타 클라이언트에서 원격 MCP 서버에 연결할 수 있습니다.

workers-mcp 란 무엇인가요?

이 패키지는 Claude Desktop(또는 모든 MCP 클라이언트 )을 계정의 Cloudflare Worker에 연결하는 CLI 도구와 Worker 내부 로직을 모두 제공하므로 필요에 맞게 사용자 지정할 수 있습니다. Worker의 TypeScript 메서드를 다음과 같이 변환할 수 있는 빌드 단계를 통해 작동합니다.

지엑스피1

... 로컬 Node.js 서버가 MCP 클라이언트에 노출할 수 있는 MCP 도구로 변환합니다. Node.js 서버는 프록시 역할을 하여 로컬에서 stdio 전송을 처리하고 Cloudflare에서 실행 중인 Worker의 관련 메서드를 호출합니다. 이를 통해 앱의 모든 함수나 API 또는 Cloudflare 개발자 플랫폼 의 모든 서비스를 코딩 에이전트, Claude Desktop 또는 기타 MCP 클라이언트의 LLM에 다시 노출할 수 있습니다.

네, Math.random() 이 로컬 머신에서와 마찬가지로 Worker에서도 동일하게 작동한다는 걸 알고 있습니다. 하지만 Claude에게는 말하지 마세요. 🤫

용법

1단계: 새 작업자 생성

create-cloudflare 사용하여 새로운 Worker를 생성합니다.

npx create-cloudflare@latest my-new-worker

Hello World 워커를 선택하는 것이 좋습니다.

2단계: workers-mcp 설치

cd my-new-worker # I always forget this bit
npm install workers-mcp

3단계: setup 명령 실행

npx workers-mcp setup

참고: 문제가 발생하면 npx workers-mcp help 실행하세요.

4단계..♾️: 반복

Worker 코드를 변경한 후에는 npm run deploy 만 실행하면 Claude의 함수에 대한 메타데이터와 라이브 Worker 인스턴스가 모두 업데이트됩니다.

하지만 메서드 이름이나 매개변수를 변경하거나 메서드를 추가 또는 제거하는 경우 Claude는 다시 시작하기 전까지 업데이트를 볼 수 없습니다.

npx workers-mcp install:claude 다시 실행할 필요는 없지만, Claude 구성을 오류의 원인으로 배제하고 싶다면 다시 실행하는 것이 안전합니다.

Related MCP server: Remote MCP Server Authless

다른 MCP 클라이언트와 함께 사용

커서

Cursor에서 Cloudflare MCP 서버를 작동시키려면 구성 파일에서 'command'와 'args'를 단일 문자열로 결합하고 'command'를 입력해야 합니다.

예를 들어, 구성 파일이 다음과 같다면:

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "/path/to/workers-mcp",
      "args": [
        "run",
        "your-mcp-server-name",
        "https://your-server-url.workers.dev",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

커서에서 다음을 사용하여 MCP 서버 항목을 만듭니다.

• 유형: command

• 명령어: /path/to/workers-mcp run your-mcp-server-name https://your-server-url.workers.dev /path/to/your/project

다른 MCP 클라이언트

Windsurf 및 기타 MCP 클라이언트의 경우 작업자를 포함하도록 구성 파일을 업데이트하여 클라이언트에서 직접 도구를 사용할 수 있도록 하세요.

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "/path/to/workers-mcp",
      "args": [
        "run",
        "your-mcp-server-name",
        "https://your-server-url.workers.dev",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

자리 표시자를 실제 서버 이름, URL, 프로젝트 경로로 바꿔야 합니다.

예시

이것을 어떤 용도로 사용할지에 대한 몇 가지 아이디어는 examples 디렉토리에서 확인하세요.

• examples/01-hello-world 는 위의 설치 지침에 따라 촬영한 스냅샷입니다.

• examples/02-image-generation Workers AI를 사용하여 Flux 이미지 생성 모델을 실행합니다. Claude는 프롬프트를 제안하는 데 매우 능숙하며, 결과를 실제로 해석하고 원하는 결과를 얻기 위해 어떤 새로운 프롬프트를 시도해야 할지 결정할 수 있습니다.

• TODO 브라우저 렌더링

• TODO 내구성 있는 물건