MCP 클라이언트 구성 서버

이 MCP 서버는 다양한 MCP 클라이언트의 구성을 관리하는 데 도움이 됩니다. 클라이언트 구성 파일에서 서버 구성을 검색, 나열, 추가 및 제거하는 도구를 제공합니다. 서버는 운영 체제(Windows 또는 macOS)와 지정된 클라이언트에 따라 적절한 구성 파일 경로를 자동으로 감지합니다.

설치

지엑스피1

구성

AI 어시스턴트에서 이 MCP 서버를 사용하려면 MCP 설정 구성에 추가하세요.

지원되는 클라이언트

• 클라인 : 클로드 기반 코딩 도우미
• Roo Code : AI 기능을 갖춘 코드 편집기
• WindSurf : AI 기반 브라우저
• Claude 앱 : Claude AI용 데스크톱 애플리케이션

참고: 커서는 MCP 설정에 표준 구성 파일을 사용하지 않으므로 더 이상 지원되지 않습니다. 커서는 MCP 구성을 쉽게 수정할 수 없는 방식으로 저장하는 것으로 보이며, 이로 인해 이 구성 서버의 파일 기반 접근 방식과 호환되지 않습니다.

용법

이 서버는 특히 다음과 같은 경우에 유용합니다.

1. 여러 클라이언트에서 MCP 서버 관리 : 서버를 한 번 구성하고 여러 클라이언트에 배포
2. 구성 자동화 : 스크립트는 이 서버를 사용하여 MCP 구성을 프로그래밍 방식으로 관리할 수 있습니다.
3. 문제 해결 : 어떤 서버가 구성되어 있고 해당 설정이 무엇인지 쉽게 확인하세요

예: Roo Code에서 Claude 앱으로 서버 구성 복사

다음은 AI 어시스턴트를 사용하여 Roo Code에서 Claude 데스크톱 앱으로 MCP 서버 구성을 복사할 수 있는 간단한 프롬프트입니다.

AI 비서는 다음 단계를 백그라운드에서 실행합니다.

1. Roo Code에서 서버 구성을 가져옵니다.

2. 그런 다음 Claude에 동일한 구성을 추가합니다.

이를 통해 다양한 AI 어시스턴트에서 MCP 서버 구성을 쉽게 동기화할 수 있습니다.

도구

get_configuration_path

지정된 클라이언트에 대한 구성 파일의 경로를 검색합니다.

매개변수:

• client (필수): 클라이언트 이름(cline, roo_code, windsurf, claude)

보고:

• 구성 파일의 절대 경로

get_configuration

지정된 클라이언트에 대한 전체 구성을 검색합니다.

매개변수:

• client (필수): 클라이언트 이름(cline, roo_code, windsurf, claude)

보고:

• 클라이언트 구성 파일의 전체 JSON 구성

서버 목록

지정된 클라이언트 구성에 구성된 모든 서버 이름을 나열합니다.

매개변수:

• client (필수): 클라이언트 이름(cline, roo_code, windsurf, claude)

보고:

• 서버 이름의 배열

get_server_configuration

클라이언트 구성에서 특정 서버에 대한 구성을 검색합니다.

매개변수:

• client (필수): 클라이언트 이름(cline, roo_code, windsurf, claude)
• server_name (필수): 검색할 서버의 이름

보고:

• 지정된 서버에 대한 JSON 구성

서버 구성 추가

클라이언트의 구성 파일에 서버 구성을 추가하거나 업데이트합니다.

매개변수:

• client (필수): 클라이언트 이름(cline, roo_code, windsurf, claude)
• server_name (필수): 추가하거나 업데이트할 서버의 이름
• json_config (필수): JSON 형식의 서버 구성

예:

보고:

• 업데이트된 구성이 포함된 성공 메시지

서버 구성 제거

클라이언트 구성 파일에서 서버 구성을 제거합니다.

매개변수:

• client (필수): 클라이언트 이름(cline, roo_code, windsurf, claude)
• server_name (필수): 제거할 서버의 이름

보고:

• 제거된 구성 또는 서버를 찾을 수 없다는 메시지

구현 세부 사항

• 서버는 운영 체제(Windows 또는 macOS)와 지정된 클라이언트에 따라 적절한 구성 파일 경로를 감지합니다.
• 모든 구성 파일은 수정 후 아름다운 JSON 형식으로 유지됩니다.
• 구성 파일이 존재하지 않거나 액세스할 수 없는 경우 오류 처리가 제공됩니다.
• 구성 파일과 디렉토리가 존재하지 않으면 서버가 자동으로 생성합니다.
• 각 클라이언트에 대한 구성 경로:
  • 윈도우 :
    • 클라인: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
    • Roo 코드: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
    • 윈드서프: %APPDATA%\WindSurf\mcp_settings.json
    • 클로드: %APPDATA%\Claude\claude_desktop_config.json
  • 맥OS :
    • 클라인: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
    • Roo 코드: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
    • 윈드서프: ~/.codeium/windsurf/mcp_config.json
    • 클로드: ~/Library/Application Support/Claude/claude_desktop_config.json

문제 해결

일반적인 문제

1. 구성 파일을 찾을 수 없습니다
   • 새로운 서버를 추가할 때, 구성 파일이 존재하지 않으면 자동으로 생성됩니다.
   • 다른 작업의 경우, 구성 파일이 없으면 오류 메시지가 표시됩니다.
2. 서버가 이미 존재합니다
   • 이미 존재하는 서버를 추가하는 경우 allow_override``true 로 설정하여 업데이트해야 합니다.
   • 예:
     { "client": "cline", "server_name": "existing-server", "json_config": { /* new config */ }, "allow_override": true }
3. 지원되지 않는 플랫폼
   • 현재는 Windows와 macOS만 지원됩니다.
   • 향후 버전에서는 Linux 지원이 추가될 수 있습니다.

모범 사례

• 서버를 업데이트하거나 제거하기 전에 항상 서버가 존재하는지 확인하세요.
• 클라이언트 전체에서 일관된 서버 이름을 사용하면 관리가 더 쉬워집니다.
• 서버 구성에서 민감한 정보에 대해서는 환경 변수를 사용하는 것을 고려하세요.