Vercel MCP 서버 🚀

🔥 Cursor의 Composer와 Codeium의 Cascade를 통해 Vercel 배포에 대한 완벽한 관리 제어 기능을 제공하는 강력한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 도구는 배포, 도메인, 환경 변수 등에 대한 포괄적인 기능을 제공하여 원활한 프로젝트 관리를 지원합니다.

📚 목차

• 필수 조건
• 빠른 시작
• 통합
• 특징
• 용법
• 보안 참고 사항
• 문제 해결
• 기여하다
• 특허

🔧 필수 조건

• 노드.js >= 16.x
• npm >= 8.x
• 다음이 포함된 Vercel 계정:
  • 액세스 토큰
  • 팀 ID(선택 사항)
  • 프로젝트 ID(선택 사항)
• 커서 IDE 또는 Codeium의 Cascade(유료 사용자용)

🚀 빠른 시작

📥 설치

지엑스피1

⚙️ 구성

1. 종속성을 설치하고 프로젝트를 빌드합니다.
   npm install npm run build
2. Vercel 액세스 토큰을 설정하세요:
   • https://vercel.com/account/tokens 로 이동하여 액세스 토큰을 생성하세요.
   • 다음 두 파일의 토큰을 업데이트하세요.src/config/constants.ts 에서:
     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
     src/index.ts 에서:
     export const DEFAULT_ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"; // Replace with your actual token
3. 커서의 MCP 설정에서 다음 명령을 사용하여 서버를 추가합니다.macOS의 경우:
   # Default installation /usr/local/bin/node /path/to/vercel-mcp/dist/index.js # Homebrew installation /opt/homebrew/bin/node /path/to/vercel-mcp/dist/index.js # NVM installation ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
   Windows의 경우:
   # Default installation C:\Program Files\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js # NVM for Windows C:\nvm4w\nodejs\node.exe C:\path\to\vercel-mcp\dist\index.js # Scoop installation C:\Users\username\scoop\apps\nodejs\current\node.exe C:\path\to\vercel-mcp\dist\index.js
   Linux의 경우:
   # Default installation /usr/bin/node /path/to/vercel-mcp/dist/index.js # NVM installation ~/.nvm/versions/node/v18.x.x/bin/node /path/to/vercel-mcp/dist/index.js
   /path/to/vercel-mcp 또는 C:\path\to\vercel-mcp 실제 설치 경로로 바꾸세요.Node.js 경로를 찾으려면:
   # macOS/Linux which node # Windows where node

참고: Vercel 액세스 토큰을 안전하게 보관하고 버전 제어에 커밋하지 마세요.

🎯 특징

🎯 사용 가능한 도구

팀 관리

• 팀: create_team , delete_team , get_team , list_teams , update_team
• 팀 구성원: list_team_members , invite_team_member , remove_team_member , update_team_member

프로젝트 관리

• 프로젝트: list_projects , create_project , delete_project , update_project , pause_project
• 프로젝트 멤버: add_project_member , list_project_members , remove_project_member
• 프로젝트 이전: request_project_transfer , accept_project_transfer

배포 관리

• 배포: create_deployment , cancel_deployment , get_deployment , delete_deployment , list_deployment
• 배포 이벤트: get_deployment_events , update_deployment_integration
• 배포 파일: list_deployment_files , upload_deployment_files , get_deployment_file
• 프로모션: promote_deployment , get_promotion_aliases

도메인 및 DNS 관리

• 도메인: add_domain , remove_domain , get_domain , list_domains , get_project_domain
• 도메인 작업: domain_check , domain_price , domain_config , domain_registry , domain_get , domain_list , domain_buy , domain_register , domain_remove , domain_update
• DNS: create_dns_record , delete_dns_record , list_dns_records , update_dns_record
• 인증서: get_cert , issue_cert , remove_cert , upload_cert

환경 및 구성

• 환경 변수: add_env , update_env , delete_env , get_env , list_env
• Edge 구성: create_edge_config , update_edge_config , delete_edge_config , get_edge_config , list_edge_configs
• Edge 구성 항목: list_edge_config_items , get_edge_config_item , update_edge_config_items
• Edge Config 스키마: get_edge_config_schema , update_edge_config_schema , delete_edge_config_schema
• Edge Config 토큰: create_edge_config_token , get_edge_config_token , list_edge_config_tokens , delete_edge_config_tokens
• Edge Config 백업: list_edge_config_backups , get_edge_config_backup

출입 통제 및 보안

• 액세스 그룹: create_access_group , delete_access_group , update_access_group , get_access_group , list_access_groups
• 그룹 프로젝트 액세스: create_access_group_project , delete_access_group_project , get_access_group_project , list_access_group_projects
• 액세스 그룹 구성원: list_access_group_members
• 인증: create_auth_token , delete_auth_token , get_auth_token , list_auth_tokens , sso_token_exchange
• 방화벽: create_firewall_bypass , delete_firewall_bypass , get_firewall_bypass , get_attack_status , update_attack_mode , get_firewall_config , update_firewall_config , put_firewall_config

모니터링 및 로깅

• 로그 드레인: logdrain_create , logdrain_createIntegration , logdrain_delete , logdrain_deleteIntegration , logdrain_get , logdrain_list , logdrain_listIntegration
• 웹훅: create_webhook , delete_webhook , list_webhooks , get_webhook
• 분석: send_web_vitals

사용자 관리

• 사용자: delete_user , get_user , list_user_events

마켓플레이스 및 통합

• 마켓플레이스: create_marketplace_event , get_marketplace_account , get_marketplace_invoice , get_marketplace_member , import_marketplace_resource , submit_marketplace_billing , submit_marketplace_invoice , update_marketplace_secrets , marketplace_sso_token_exchange , submit_marketplace_balance , marketplace_invoice_action
• 통합: int_delete , int_list , int_gitns , int_searchRepo , int_get , int_updateAction

환경과 비밀

• 환경: create_environment , delete_environment , get_environment , list_environments , update_environment
• 비밀: create_secret , update_secret_name , delete_secret , get_secret , list_secrets

아티팩트 및 별칭

• 아티팩트: check_artifact , download_artifact , get_artifact_status , query_artifacts , record_artifact_events , upload_artifact
• 별칭: assign_alias , delete_alias , get_alias , list_aliases , list_deployment_aliases

💡 사용법

MCP 서버는 구성이 완료되면 Cursor's Composer를 통해 모든 Vercel 관리 도구를 제공합니다. Vercel 프로젝트에서 무엇을 할지 간단히 설명하면 AI가 적절한 명령을 실행합니다.

예:

• 📋 "내 모든 프로젝트 나열"
• 🚀 "새로운 Next.js 프로젝트를 만드세요"
• 🌐 "내 프로젝트에 사용자 지정 도메인 추가"
• 🔑 "환경 변수 설정"

🔒 보안 참고 사항

• 🔐 Vercel 액세스 토큰을 안전하게 보관하세요
• ⚠️ 민감한 자격 증명을 버전 제어에 커밋하지 마십시오.
• 👮 적절한 액세스 제어 및 권한을 사용하세요
• 🛡️ Vercel의 보안 모범 사례를 따르세요

🛠️ 문제 해결

일반적인 문제

1. Node.js 경로 문제
   • 올바른 Node.js 경로를 사용하고 있는지 확인하세요.
   • Mac/Linux에서: 올바른 경로를 찾는 데 which node 사용하세요
   • Windows에서: where node 사용하여 올바른 경로를 찾으세요.
2. 액세스 토큰 문제
   • Vercel 액세스 토큰이 유효한지 확인하세요
   • 토큰에 필요한 권한이 있는지 확인하세요
   • 토큰이 만료되지 않았는지 확인하세요
3. MCP가 도구를 감지하지 못함
   • 커서의 MCP 설정에서 새로 고침 버튼을 클릭하세요.
   • 서버가 실행 중인지 확인하세요(오류 메시지 없음)
   • Vercel 자격 증명이 유효한지 확인하세요

디버그 모드

자세한 로그를 보려면 명령 앞에 DEBUG=true 추가하세요.

여전히 문제가 발생하는 경우 다음 주소로 문제를 제기해 주세요.

• 귀하의 운영 체제
• Node.js 버전( node --version )
• 전체 오류 메시지
• 재현 단계

🤝 기여하기

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

📄 라이센스