Cursor MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

커서 MCP - Claude Desktop 통합

Cursor IDE를 통해 Claude AI와 데스크톱 애플리케이션 간의 원활한 통합을 지원하는 모델 컨텍스트 프로토콜(MCP) 구현입니다. 이 도구는 Claude의 기능과 데스크톱 소프트웨어를 연결하는 다리 역할을 하여 향상된 AI 기반 개발 워크플로를 구현합니다.

빠른 시작(Windows)

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Cursor를 자동으로 설치하려면:

지엑스피1

수동 설치

  1. 필수 조건
  2. 설치
    # Install globally npm install -g mcp-cursor # Or install locally git clone https://github.com/yourusername/cursor-mcp.git cd cursor-mcp npm install
  3. 구성
    • 프로젝트 루트에 .env 파일을 만듭니다.
      # Windows path example DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces
  4. Claude의 MCP 구성에 추가 Claude 구성에 다음을 추가합니다.
    { "name": "cursor", "type": "mcp", "config": { "server": "https://glama.ai/mcp/servers/4fg1gxbcex", "capabilities": ["cursor_control", "window_management"] } }
  5. 서버 시작
    # If installed globally mcp-cursor # If installed locally npm start

특징

  • 개발 워크플로우에서 실시간 AI 지원
  • 컨텍스트 인식 코드 제안 및 완성
  • Cursor IDE와의 원활한 통합
  • 생산성 향상을 위한 Windows 자동화

자세한 설정

지역 개발 설정

  1. 복제하고 설치하세요:
    git clone https://github.com/yourusername/cursor-mcp.git cd cursor-mcp npm install
  2. 환경 구성을 생성합니다.
    cp .env.example .env
    .env 편집하고 작업 공간 경로를 설정합니다.
    DEFAULT_WORKSPACE_PATH=C:/Users/YourUsername/Documents/cursor-workspaces
  3. 빌드하고 실행:
    # Development mode with hot reload npm run dev # Production mode npm run build npm start

문제 해결

  1. 창 감지 문제
    • 커서 IDE가 실행 중인지 확인하세요
    • MCP 서버를 다시 시작해 보세요.
    • 작업 공간 경로가 올바른지 확인하세요
  2. 권한 문제
    • 최초 설정 시 관리자 권한으로 터미널을 실행하세요.
    • 작업 공간 디렉토리에서 적절한 파일 권한을 확인하세요.
  3. 노드 버전 문제
    • nvm 사용하여 Node.js v18 이상으로 전환하세요.
      nvm install 18 nvm use 18

프로젝트 구조

cursor-mcp/ ├── src/ # Source code │ ├── services/ # Core services │ ├── handlers/ # Event handlers │ └── types/ # TypeScript definitions ├── build/ # Compiled JavaScript └── .env # Environment configuration

스크립트

  • npm run build - TypeScript 컴파일
  • npm start - 프로덕션 서버 실행
  • npm run dev - 핫 리로드로 개발 서버 시작

기여하다

  1. 저장소를 포크하세요
  2. 기능 브랜치 생성( git checkout -b feature/amazing-feature )
  3. 변경 사항 커밋( git commit -m 'Add feature' )
  4. 브랜치에 푸시( git push origin feature/amazing-feature )
  5. 풀 리퀘스트 열기

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

지원하다

지원을 위해:

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude와의 실시간 코드 인덱싱, 분석, 양방향 통신을 가능하게 하여 Cursor 코드 편집기와의 통합을 용이하게 하며, 동시 세션과 자동 재연결을 지원합니다.

  1. Quick Start (Windows)
    1. Installing via Smithery
    2. Installing Manually
  2. Features
    1. Detailed Setup
      1. Local Development Setup
      2. Troubleshooting
    2. Project Structure
      1. Scripts
        1. Contributing
          1. License
            1. Support
              ID: 4fg1gxbcex