Skip to main content

GitHub에서 MCP 서버 추가

이 가이드는 Cline을 사용하여 GitHub 저장소에서 기존 MCP 서버를 구축하는 방법에 대한 단계별 지침을 제공합니다.

MCP 서버 찾기​

온라인에는 MCP 서버를 찾을 수 있는 여러 곳이 있습니다.

  • Cline은 MCP 서버를 목록에 자동으로 추가할 수 있으며, 이를 편집할 수 있습니다. Cline은 GitHub에서 직접 저장소를 복제하고 서버를 구축할 수 있습니다.

  • GitHub: GitHub에서 MCP 서버를 찾을 수 있는 가장 일반적인 두 곳은 다음과 같습니다.

  • 온라인 디렉토리: 여러 웹사이트에서 MCP 서버를 나열합니다.

    이러한 디렉토리는 사용자가 다운로드, 날짜, 별표 및 사용 사례와 같은 다양한 기준으로 서버를 정렬할 수 있도록 합니다. 각 항목은 기능, 도구 및 구성 지침과 같은 정보를 제공합니다.

  • PulseMCP: 이 웹사이트에는 AI가 MCP 서버를 사용하여 웹사이트를 쓸모없게 만들 수 있는 방법에 대해 논의하는 블로그 게시물이 있습니다. PulseMCP에는 MCP 서버에 대한 FAQ 섹션도 포함되어 있습니다: https://www.pulsemcp.com/

Cline으로 구축​

  1. 프로세스 시작: Cline에 다음 정보를 제공합니다.

    • GitHub 저장소 URL: 서버 저장소의 URL입니다.
    • README.md 내용: 선택 사항이지만 Cline이 서버의 목적과 구성을 이해하는 데 도움이 됩니다. GitHub 저장소에서 README.md 파일을 복사할 수 있습니다.

  2. Cline과의 상호 작용 예시:

    사용자: "Caret, Brave 브라우저 제어를 위한 MCP 서버를 추가하고 싶어. GitHub 링크는 여기야: @https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search 추가해 줄 수 있니?"

    Caret: "알겠습니다. 저장소를 MCP 디렉토리에 복제합니다. 'package.json' 파일이 있으므로 빌드해야 합니다. 'npm run build'를 실행할까요?"

    사용자: "네, 빌드해 주세요."

    Caret: "빌드 완료. 이 서버에는 브라우저 경로가 필요합니다. Brave 브라우저 실행 파일은 어디에 있나요?"

    사용자: "'/Applications/Brave Browser.app/Contents/MacOS/Brave Browser'에 있습니다."

    Caret: "알겠습니다. 해당 경로로 서버 구성을 업데이트하고 'cline_mcp_settings.json'에 추가했습니다. 다른 것은 없나요?"

    사용자: "아니요, 그게 다입니다. 테스트해 봅시다."

    Caret: "좋습니다! 서버 연결을 테스트하기 위해 MCP Inspector를 시작합니다. 그 후 Cline에서 브라우저를 제어해 볼 수 있습니다."

  3. Cline의 작업: 지침에 따라 Cline은 다음을 수행합니다.

    • 저장소 복제: Cline은 저장소를 로컬 머신에 복제하며, 일반적으로 구성에 지정된 디렉토리에 복제합니다.
    • 조정: 서버 구성을 수정하도록 Cline을 안내할 수 있습니다. 예를 들어:
      • 사용자: "이 서버에는 API 키가 필요합니다. 어디에 추가해야 하는지 찾을 수 있나요?"
      • Cline은 지침에 따라 cline_mcp_settings.json 파일 또는 기타 관련 파일을 자동으로 업데이트할 수 있습니다.
    • 서버 구축: Cline은 서버에 대한 적절한 빌드 명령을 실행하며, 일반적으로 npm run build입니다.
    • 설정에 서버 추가: Cline은 서버 구성을 cline_mcp_settings.json 파일에 추가합니다.

테스트 및 문제 해결​

  1. 서버 테스트: Cline이 빌드 프로세스를 완료하면 서버가 예상대로 작동하는지 테스트하십시오. 문제가 발생하면 Cline이 도움을 줄 수 있습니다.
  2. MCP Inspector: MCP Inspector를 사용하여 서버의 연결 및 기능을 테스트할 수 있습니다.

모범 사례​

  • 기본 사항 이해: Cline이 프로세스를 단순화하지만, 서버 코드, MCP 프로토콜(자세히 알아보기) 및 서버 구성 방법에 대한 기본적인 이해를 갖는 것이 좋습니다. 이는 더 효과적인 문제 해결 및 사용자 지정을 가능하게 합니다.
  • 명확한 지침: 프로세스 전반에 걸쳐 Cline에 명확하고 구체적인 지침을 제공하십시오.
  • 테스트: 설치 및 구성 후 서버를 철저히 테스트하여 올바르게 작동하는지 확인하십시오.
  • 버전 제어: 버전 제어 시스템(Git 등)을 사용하여 서버 코드 변경 사항을 추적하십시오.
  • 최신 상태 유지: 최신 기능 및 보안 패치의 이점을 얻기 위해 MCP 서버를 최신 상태로 유지하십시오.