Cloudflare MCP Server — 코드 모드

Cloudflare Workers에서 원격 Model Context Protocol (MCP) 서버를 구축하기 위한 서버리스 스타터입니다.

이 프로젝트는 코드 모드용으로 설계되었습니다: 클라이언트는 기능을 발견하고 구조화된 응답으로 도구 호출을 구성할 수 있습니다. 임의 코드 실행은 스타터에서 활성화되어 있지 않습니다; 이 기능은 샌드박스, 인증, 한도 및 감사를 정의한 후에만 추가해야 합니다.

목표

• Cloudflare Workers를 통해 엣지에서 실행합니다.

• /mcp에서 MCP 엔드포인트를 노출합니다.

• 작고, 타입이 지정된, 조합 가능한 도구를 유지합니다.

• OAuth 인증 및 Cloudflare 바인딩을 준비합니다.

• 격리된 샌드박스에서 안전한 코드 실행으로 발전합니다.

Related MCP server: Adi MCP

로컬 개발

전제 조건: Node.js 18+ 및 Workers가 활성화된 Cloudflare 계정.

npm install
npm run dev

로컬 서버는 http://localhost:8788/mcp에서 사용할 수 있습니다.

MCP Inspector로 검증하려면:

npx @modelcontextprotocol/inspector@latest

배포

npx wrangler login
npm run deploy

배포 후 엔드포인트는 다음과 같습니다.

https://<worker>.<account>.workers.dev/mcp

구조

• src/index.ts: Worker의 HTTP 라우팅.

• src/mcp.ts: MCP 서버와 도구.

• wrangler.jsonc: Worker 구성.

• PLAN.md: 구현 계획 및 승인 기준.

보안

Worker에 직접 eval, new Function, 또는 코드 인터프리터를 추가하지 마십시오. 실제 실행이 포함된 코드 모드에서는 적절한 샌box, 강력한 인증, API 허요 목록, CPU/메모리/시간 제한, 사용자별 결리, 비밀값이 없는 로고를 사용하세요.

다음 단계

PLAN.md에서 참조하세요.