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를 생성합니다.

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

2단계: workers-mcp 설치

3단계: 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

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

커서

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

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

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

• 유형: command

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

다른 MCP 클라이언트

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

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

예시

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

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

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

• TODO 브라우저 렌더링

• TODO 내구성 있는 물건