local-only server

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

Integrations

Provides Google Drive integration for file management, allowing the MCP server to interact with Google Drive for storing and retrieving files.

커서용 MCP 서버

SSE(Server-Sent Events) 및 WebSocket 연결을 통해 최신 웹 대시보드와 도구를 제공하는 Cursor IDE 통합을 위한 MCP(Model Context Protocol) 서버 구현입니다.

특징

WebSocket 지원을 통한 실시간 연결 모니터링
서버 관리를 위한 최신 웹 대시보드
커서 IDE를 사용한 SSE 기반 통신
연결성 확인을 위한 내장 테스트 도구
파일 관리를 위한 Google Drive 통합
새로운 도구 추가를 위한 확장 가능한 아키텍처
연결 내역 시각화
클라이언트 관리 인터페이스
서비스 구성 UI
사용자 정의 가능한 서버 설정

필수 조건

Python 3.8 이상
Node.js 18 이상
npm(Node.js 패키지 관리자)
pip(Python 패키지 관리자)
커서 IDE

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

# Install all dependencies (both backend and frontend)
npm run install-all

# Or install separately:
# Backend dependencies
pip install -r requirements.txt

# Frontend dependencies
cd frontend
npm install
cd ..

개발

개발 서버를 시작합니다.

# Start both backend and frontend in development mode
npm run dev   # This will start both servers concurrently

서버는 다음 위치에서 시작됩니다.

백엔드: http://localhost:8765
프런트엔드: http://localhost:3000 (또는 포트 3000이 사용 중인 경우 3001 )

서버를 별도로 시작할 수도 있습니다.

# Backend (in one terminal)
python mcp_server.py

# Frontend (in another terminal)
cd frontend
npm run dev

개발 서버는 다음을 제공합니다.

프런트엔드 변경 사항에 대한 핫 리로딩
백엔드에 대한 API 요청의 자동 프록시
WebSocket 연결 처리
동시 백엔드 및 프런트엔드 개발

포트 3000을 사용하는 다른 애플리케이션을 실행 중인 경우, 프런트엔드는 자동으로 포트 3001을 시도하고 사용 가능한 포트를 찾을 때까지 포트를 증가시킵니다. npm run dev 실행하면 실제 URL이 터미널에 표시됩니다.

프로젝트 구조

MCP-Server/
├── frontend/                # Frontend application
│   ├── src/                # Source code
│   │   ├── api/           # API clients
│   │   ├── pages/         # React components
│   │   └── main.tsx       # Entry point
│   ├── package.json       # Frontend dependencies
│   └── vite.config.ts     # Vite configuration
├── mcp_server.py          # Main server implementation
├── services.py            # Service management
├── test_client.py         # Test client implementation
├── requirements.txt       # Python dependencies
├── package.json           # Root package.json
└── services_config.json   # Service configurations

사용 가능한 엔드포인트

HTTP 엔드포인트

/api/status - 서버 상태 가져오기
/api/connections/history - 연결 기록 가져오기
/api/clients - 활성 클라이언트 가져오기
/api/services/{service_id} - 서비스 구성
/api/settings - 서버 설정

웹소켓 엔드포인트

/ws/{client_id} - 실시간 업데이트 및 핑퐁

SSE 엔드포인트

/sse - 커서 IDE용 서버 전송 이벤트

도구 엔드포인트

/invoke/test - 테스트 도구
/invoke/google_drive - Google 드라이브 작업

프로덕션 배포

프로덕션 서버를 빌드하고 시작합니다.

# Build frontend and start production server
npm run prod

# Or build frontend separately:
npm run build
python mcp_server.py

구성

초기 설정

템플릿 구성을 복사합니다.

cp services_config.template.json services_config.json

서비스 자격 증명으로 services_config.json 업데이트합니다.
- Google 드라이브의 경우:
  - Google Cloud Console에서 프로젝트 만들기
  - Google 드라이브 API 활성화
  - OAuth 2.0 자격 증명 만들기
  - client_id 와 client_secret 추가하세요

서버 설정

웹 대시보드를 통해 서버 설정을 구성하세요.

디버그 모드
SSL 설정
연결 제한
핑 시간 초과
프로토콜 설정

테스트

제공된 테스트 클라이언트를 사용하여 서버를 테스트하세요.

python test_client.py

테스트 클라이언트는 다음을 수행합니다.

SSE 및 WebSocket 엔드포인트에 모두 연결
주기적 ping 보내기
사용 가능한 도구 테스트
연결 상태 모니터링

문제 해결

연결 문제
- 백엔드와 프런트엔드 로그를 모두 확인하세요
- 브라우저 DevTools에서 WebSocket 연결 확인
- vite.config.ts 의 프록시 설정이 올바른지 확인하세요.
- 포트 충돌 확인
프런트엔드 문제
- 브라우저 캐시 지우기
- 브라우저 콘솔에서 오류를 확인하세요.
- Node.js 및 npm 버전 확인
- TypeScript 컴파일 오류 확인
백엔드 문제
- mcp_server.log 에서 오류를 확인하세요.
- Python 종속성이 설치되었는지 확인하세요
- 포트 가용성 확인
- 서비스 구성이 유효한지 확인하세요

보안 참고 사항

서버는 개발 중인 모든 출처(CORS * )를 허용합니다.
WebSocket 연결은 기본 식별을 위해 클라이언트 ID를 사용합니다.
서비스 자격 증명은 services_config.json 에 저장됩니다.
프로덕션 환경에서는 민감한 데이터에 환경 변수를 사용해야 합니다.

기여하다

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 만드세요
테스트 실행
풀 리퀘스트 제출

특허

[여기에 라이센스 정보를 추가하세요]

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

SSE 및 WebSocket 연결을 통해 실시간 통신, 최신 웹 대시보드, 확장 가능한 도구를 제공하는 Cursor IDE와 통합된 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

MCP Server for Cursor