MCP 서버 설정 공유

MCP Server 공유하기

.cursor/mcp.json

Cursor는 .cursor/mcp.json 파일을 통해 MCP 서버 설정을 자동으로 인식하고 사용함

  • mcp.json: cursor 설정이 자동으로 읽는 최종 mcp 설정 파일

  • default_mcp.json: 개발자들이 공유하는 상대 경로 기반의 설정 템플릿 파일

    • command: "/Users/.../.nvm/versions/node/.../bin/node" node가 설치된 경로

    • args: "/mcp-server/think-mcp-server/bin/server.js" 각 mcp server 빌드 결과물로 지정

  • makeMcpPath.js: default_mcp.json 을 읽어 OS를 감지하고 절대 경로로 변환하여 mcp.json을 생성하는 스크립트

절대 경로 이슈

  • Cursor는 mcpServers를 설정시 command 필드에 절대 경로를 요구

  • 이로인해 OS나 로컬환경에 따라 경로 충돌 문제가 발생할 수 있음

  • nvm과 같은 버전 관리 도구를 사용하는 경우, mcpServers 설정시 노드 실행파일의 절대 경로를 명확하게 지정해야함

  • OS에 따라 절대 경로가 다를 수 있으므로 이것을 맞춰주는 솔루션 필요

    • 1. 상대 경로를 입력한 default_mcp.json 파일을 생성하여 Git에 공유

    • 2. makMcpPath.js 스크립트 실행

    • 3. 최종적으로 절대 경로로 설정된 mcp.json 파일 생성 (mcp.json은 환경마다 내용이 달라지므로 .gitignore 에 추가하여 관리)

makeMcpPath.js

.cursor/mcp-server/

  • mcp-server/ 하위에 mcp server를 git clone

  • MCP 서버의 의존성 관리 및 설치 편의를 위해 Workspaces 기능 활용

  • workspaces를 정의하게되면 npm install 실행시 해당 경로의 package.json 에 정의된 모듈(의존성)들도 함께 설치하게됨

Last updated