일반 소개
Cloudflare 작업자 MCP 는 Cloudflare에서 개발하여 GitHub에서 호스팅하는 오픈 소스 프로젝트로, 개발자가 Cloudflare Workers 기반 MCP(모델 컨텍스트 프로토콜) 서버를 신속하게 구축하고 배포할 수 있도록 설계되었습니다. 이 도구는 Cloudflare Workers의 강력한 클라우드 컴퓨팅 기능과 MCP 프로토콜을 결합하여 사용자가 간단한 TypeScript 함수를 통해 사용자 지정 도구를 만들고 다음과 같은 MCP 지원 클라이언트에 통합할 수 있게 해줍니다. 인류학 (명목식 형태로 사용됨) Claude 데스크톱). 특히 효율적이고 가벼운 서버 기능을 달성하기 위해 Cloudflare 인프라를 사용하여 R2, D1, KV 등의 서비스를 지원하려는 개발자에게 적합합니다. 배포 프로세스가 간단하고 개발 경험이 원활하여 기술 커뮤니티에서 매우 인기가 있습니다.

기능 목록
- MCP 서버 빠른 설정CLI 도구를 통해 MCP 서버를 빠르게 생성하고 Cloudflare Workers에 배포합니다.
- 타입스크립트 개발 지원TypeScript로 함수를 작성하고 JSDoc 어노테이션을 사용하여 도구 설명을 생성합니다.
- Cloudflare 서비스 통합R2(객체 저장소), D1(데이터베이스), KV(키-값 저장소) 및 기타 함수 호출을 지원합니다.
- MCP 클라이언트와의 원활한 연결사용자 지정을 위해 클로드 데스크톱과 같은 MCP 클라이언트와 인터페이스합니다.
- 자동 문서 생성코드의 JSDoc 주석에서 LLM 친화적인 도구 문서를 자동으로 생성합니다.
- 효율적인 배포 프로세스랭글러 CLI와 함께 Cloudflare의 글로벌 네트워크에 원클릭 배포.
- 지역 개발 지원디버깅 및 반복을 위한 로컬 테스트 환경을 제공합니다.
도움말 사용
설치 프로세스
Cloudflare Workers MCP를 사용하려면 몇 가지 기본 환경을 준비한 다음 아래 단계에 따라 프로젝트를 설치하고 구성해야 합니다. 전체 과정은 간단하며 기본적인 개발 경험이 있는 사용자에게 적합합니다.
1. 환경 준비
- Node.js컴퓨터에 Node.js가 설치되어 있는지 확인합니다(버전 >= 16.17.0).
node -v
버전을 확인합니다. - 랭글러 CLI: Worker 프로젝트를 배포하고 관리하기 위한 Cloudflare Workers의 공식 명령줄 도구입니다. 설치 방법:
npm install -g wrangler
설치 후 다음을 실행합니다. wrangler login
Cloudflare 계정에 로그인합니다.
- Claude 데스크톱(선택 사항)MCP 서버와 클로드 데스크톱을 통합하려면 클로드 데스크톱 애플리케이션을 다운로드하여 설치해야 합니다(공식 웹사이트: https://claude.ai/download).
- GitGitHub에서 프로젝트를 복제하려면 다음을 실행합니다.
git --version
설치되어 있는지 확인합니다.
2. 프로젝트 복제
터미널을 열고 다음 명령을 입력하여 Cloudflare Workers MCP 리포지토리를 복제합니다:
git clone https://github.com/cloudflare/workers-mcp.git
cd workers-mcp
3. 종속성 설치
프로젝트 디렉토리에 들어가면 필요한 종속성 패키지를 설치합니다. npm 또는 pnpm 중 하나를 선택할 수 있습니다:
npm install
어쩌면
pnpm install
설치가 완료되면 프로젝트에 다음과 같은 필요한 모든 라이브러리가 포함됩니다. @modelcontextprotocol/sdk
노래로 응답 tsx
.
4. 랭글러 구성하기
다음 사항을 확인하십시오. wrangler.toml
이 파일에는 Cloudflare 계정 정보가 포함되어 있습니다. 다음 명령을 실행하여 로그인하고 구성 파일을 생성합니다:
wrangler login
로그인에 성공하면 편집 wrangler.toml
추가 account_id
(Cloudflare 대시보드에서 사용 가능):
account_id = "你的账户ID"
5. 로컬 운영
MCP 서버를 로컬에서 실행하여 테스트합니다:
pnpm build
npx workers-mcp secret generate
그러면 키가 생성되고 이 키는 .dev.vars
파일을 만듭니다. 그런 다음 로컬 개발 환경을 시작합니다:
wrangler dev
액세스 프롬프트의 로컬 URL(일반적으로 http://localhost:8787
)를 클릭하고 서버가 제대로 작동하는지 확인합니다.
6. Cloudflare에 배포
오류 없이 테스트한 후 다음 명령을 사용하여 Cloudflare Workers에 배포합니다:
pnpm deploy:worker
배포가 성공적으로 완료되면 Cloudflare Worker의 URL을 받게 됩니다(예 https://your-worker.workers.dev
)를 입력하면 MCP 서버 주소입니다.
기능 작동 흐름
주요 기능: 신속한 MCP 서버 구축
- 타입스크립트 함수 작성
쇼(티켓)src/index.ts
inMyWorker
클래스를 사용하여 사용자 지정 함수를 추가할 수 있습니다. 예시:/** * 返回一个友好的问候语。 * @param name {string} 用户的名字 * @return {string} 问候语内容 */ sayHello(name: string) { return `你好,${name}!来自 MCP Worker 的问候!`; }
JSDoc 어노테이션은 자동으로 도구 설명을 생성합니다.
- 문서 생성
움직여야 합니다.pnpm build
이 도구는 JSDoc에서 사용할 수 있는 모든 JSDoc 파일 목록을 생성합니다.dist/docs.json
를 클릭하면 모든 도구의 설명과 매개변수에 대한 정보를 확인할 수 있습니다. - 테스트 기능
로컬에서 실행wrangler dev
테스트하려면 브라우저 또는 컬 테스트를 사용하여 테스트할 수 있습니다:curl http://localhost:8787
또는 Claude Desktop에서 직접 MCP 서버 주소를 구성하여
sayHello
도구.
기능: 클로드 데스크톱과 통합
- Claude 데스크톱 구성
Claude 데스크톱 구성 파일을 엽니다.claude_desktop_config.json
(일반적으로 사용자 디렉터리에 위치)에서 MCP 서버를 추가합니다:{ "mcpServers": { "my-worker": { "command": "npx", "args": ["workers-mcp", "proxy", "https://your-worker.workers.dev"] } } }
Claude 데스크톱을 저장하고 다시 시작합니다.
- 호출 도구
클로드 데스크톱에서 "sayHello 유틸리티를 호출하여 John에게 인사해 주세요"와 같이 입력하면 "안녕하세요, John!"이라는 반환 결과를 볼 수 있습니다. MCP 워커가 인사합니다!"라는 결과가 표시됩니다.
기능: Cloudflare 서비스와의 통합
- KV 스토리지 사용
존재wrangler.toml
KV 바인딩을 추가합니다.[[kv_namespaces]] binding = "MY_KV" id = "你的 KV ID"
코드에서 KV를 조작합니다:
async setValue(key: string, value: string) { await this.env.MY_KV.put(key, value); return `已存储 ${key}: ${value}`; }
- 배포 및 테스트
재배포 후setValue
도구를 사용하여 데이터가 KV에 저장되었는지 확인할 수 있습니다.
주의
- 키 관리: 실행
npx workers-mcp secret upload
보안을 위해 Cloudflare에 키를 업로드하세요. - 디버깅 팁사용
wrangler dev --remote
프로덕션 환경 바인딩에 연결하여 쉽게 디버깅할 수 있습니다. - 확장된 기능추가 클라우드플레어 서비스(예: R2, D1)는 다음을 추가하여 간단히 도입할 수 있습니다.
wrangler.toml
에서 바인딩을 구성합니다.
이 단계를 통해 Cloudflare Workers MCP를 빠르게 시작하고 강력한 MCP 서버를 구축할 수 있습니다!
© 저작권 정책
文章版权归 AI 공유 서클 所有,未经允许请勿转载。
관련 문서
댓글 없음...