ABOUT ME

소프트웨어 개발, 프로그래밍에 대한 이야기를 다룹니다.

Today
Yesterday
Total
  • 초보자를 위한 MCP 서버 사용 가이드: Claude Desktop에서 파일 관리와 유튜브 요약 기능 설정하기
    Programming/TIL 2025. 3. 30. 21:40

    MCP(Model Context Protocol)를 활용해 Claude AI의 기능을 확장하는 법을 소개합니다. Claude Desktop에서 개인 폴더와 파일을 연동하여 개인 AI 비서처럼 활용하는 방법과, 유튜브 영상의 자막을 분석하여 요약하는 기능을 추가하는 방법을 안내합니다. MCP의 개념부터 설정 방법까지 비개발자도 따라할 수 있는 실용적인 가이드를 제공합니다.

    개요

    요즘 MCP(Model Context Protocol)에 대한 관심이 아주 뜨겁습니다.

    MCP를 간단히 말해 클라이언트-서버 구조를 기반으로 AI 언어 모델과 다른 소프트웨어를 연결하는 프로토콜인데요.

    기술적인 내용을 덜어내고 비유하자면 AI를 위한 USB 포트와 같은 개념입니다.

    USB 포트로 외장 하드나 키보드, 미니 선풍기까지 연결할 수 있듯
    MCP를 통해 ChatGPT나 클로드 같은 AI 언어 모델에 추가 기능을 연결할 수 있는 것이죠.

    이를테면 파일 읽고 쓰기, 인터넷 검색, 3D 모델링과 UI 디자인, 음악 작곡과 같은 작업을 AI와 함께 수행할 수 있는 겁니다.

    물론 기존에도 AI와 함께 이런 작업을 하는 게 불가능하지는 않았습니다.
    다만 기술적 이해도가 없는 일반 사용자가 설정하고 사용하기에는 너무 복잡하고 어려웠을 뿐이죠.

    MCP의 등장과 함께 이러한 연동과정이 상당히 간편해졌습니다.
    USB 포트가 있는 컴퓨터(MCP 사용 가능한 AI프로그램)와 USB 장치(MCP 서버)를 연결하는 것처럼 말이죠.

    이번 글은 클로드(Claude)와 MCP 서버를 연결해서 유용한 기능을 추가하는 방법을 소개합니다.
    특히 파일을 읽고 쓰는 기능을 추가하여 개인 메모(옵시디언 메모)를 AI와 함께 활용하는 방법과, 유튜브 영상을 요약하는 기능을 추가하는 방법을 다룰 예정입니다.

    글은 비 개발자도 충분히 따라할 수 있도록 작성했으나, 일부 설명이 부족할 수 있습니다.
    혹여 이해가 어렵거나 잘 안되는 부분이 있다면 댓글로 남겨주세요!

    사전 설정 준비물

    Claude Desktop 설치하기

    현재 클로드 웹사이트 claude.ai에서는 MCP 서버를 지원하지 않습니다.
    USB 포트가 없는 컴퓨터에서 USB 장치를 사용할 수 없는 것과 같은 원리입니다.

    컴퓨터에 직접 설치하는 Claude Desktop에서는 MCP 서버를 사용할 수 있으므로, 이를 설치해서 진행하겠습니다.

    설치는 다운로드 페이지에서 가능합니다.

    컴퓨터 운영체제(Windows/MacOS)에 맞는 설치 파일을 다운로드 한 후, 열심히 Yes를 눌러주세요.

    이미 설치되어 있다면 좌측 상단 메뉴에서 - Help - Check for Updates 를 선택하여 최신 버전인지 확인하고 업데이트 해주세요.

    Node.js 설치하기

    Node.js가 설치되어 있어야 합니다.
    공식 다운로드 페이지에서 설치가 가능합니다.

    하단에 "x64 아키텍쳐가 실행 중인 windows환경에서 미리 빌드된 Node.js를 다운로드하세요."라는 문구가 표시됩니다.
    Mac OS를 사용하시는 경우 windows 토글 버튼을 눌러서 macOS로 변경해주세요.
    이후 아래 설치 프로그램 다운로드 버튼을 눌러서 실행하면 됩니다.

    설치 확인은:

    • MacOS라면 터미널(Terminal)을 열어서
    • Windows라면 win + R 버튼을 누르고 cmd를 입력한 뒤

    node --version를 입력해주세요. 그럴듯한 문구가 나온다면 성공입니다.

    MCP 서버 설정하기

    이제 Claude Desktop에 MCP 서버를 설정해보겠습니다.
    USB 포트에 장치를 꽂아 넣듯 MCP 서버와 클로드를 연결하는 작업입니다.

    설정은 claude_desktop_config.json 파일을 수정하는 방식으로 진행됩니다.

    아래 경로에 해당 파일을 생성하면 됩니다.

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    이런 경로가 익숙치 않으시다면:
    좌측 상단 메뉴 - File - Settings - Developer - Edit Config 버튼을 눌러주세요.
    설정 파일이 있는 폴더로 바로 이동할 수 있습니다.

    이제 claude_desktop_config.json 파일을 열어보겠습니다.
    메모장, VSCODE, Vim 등 선호하시는 파일 편집기로 파일을 열어 주세요.

    MCP 서버 설정하기: server-filesystem

    설정 파일을 열었으면 이제 MCP 서버를 추가해보겠습니다.

    클로드가 컴퓨터 내부의 폴더를 읽고 쓸 수 있도록 server-filesystem MCP 서버를 추가하겠습니다.

    파일 내용은 아래처럼 작성하면 됩니다.

    {
      "mcpServers": {
        "filesystem": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-filesystem",
            "C:\\Users\\username\\Documents",
            "C:\\Users\\username\\Downloads"
          ]
        }
      }
    }
    JSON

    "C:\\Users\\username\\Documents" 이하 부분은 클로드가 사용할 폴더 경로입니다.
    여러 폴더를 추가하려면 쉼표로 구분해주시고, 경로는 "" 따옴표로 감싸주세요.

    저는 평소에 메모를 저장해두는 Obisidan 폴더 경로를 추가하겠습니다.

    {
      "mcpServers": {
        "filesystem": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-filesystem",
            "C:\\Users\\dvbeetle\\Documents\\obsidian"
          ]
        }
      }
    }
    JSON

    만약 원하는 폴더의 경로를 잘 모를 경우, 파일 탐색기에서 폴더를 열고 주소창에 있는 내용을 복사해보세요.
    이때, Windows라면 역슬래시 \ 혹은 원화표시를 두 번씩 입력해야 합니다.
    C:\Users\dvbeetle\Documents\obsidian 대신 C:\\Users\\dvbeetle\\Documents\\obsidian로 입력해주세요.

    파일을 저장한 후, Claude Desktop을 다시 시작해주세요.

    입력 창 우측 하단에 망치 아이콘이 나타났다면 성공입니다.

    Filesystem MCP 사용해보기

    이로써 클로드가 해당 폴더에 있는 파일을 읽고 쓸 수 있게 되었습니다.

    저는 매일 옵시디언 폴더에 일기 형식으로 간단한 메모를 남기고 있습니다.
    이러한 메모를 기반으로 상반기 감정과 기분 상태에 대한 분석을 요청해 볼 수 있습니다.
    감정 분석

    메모 내용을 기반으로 취향과 관심사를 파악한 뒤, 취향에 맞는 음악 및 미술 작가를 추천받을 수도 있습니다.
    취향 분석

    그 외에도 예전에 방문했던 음식집이 기억나지 않거나, 이번 달 놓치고 있는 일이 있는지 등 메모 기반으로 클로드를 개인 비서처럼 활용할 수 있어졌습니다!!

    MCP 서버 설정하기: server-youtube-transcript

    다른 기능도 한 번 추가해볼까요?

    유튜브 링크를 입력하면, 자막을 기반으로 영상 내용을 분석해주는 기능을 추가해보겠습니다.
    Youtube Transcribe Server라는 MCP 서버를 사용하면 되는데요.

    페이지의 Configuration 파트를 보면 설정 방법이 아래와 같이 나와 있습니다.

    {
      "mcpServers": {
        "youtube-transcript": {
          "command": "npx",
          "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
        }
      }
    }
    JSON

    위 내용을 claude_desktop_config.json 파일에 추가하면 됩니다.
    이미 mcpServersfilesystem 서버가 설정되어 있으니, 그 밑에 병렬로 추가해주면 됩니다.

    쉼표로 아래와 같이 구분해서 추가해줄게요.

    {
      "mcpServers": {
        "filesystem": {
          "command": "npx",
          "args": [
            "-y",
            "@modelcontextprotocol/server-filesystem",
            "C:\\Users\\dvbeetle\\Documents\\obsidian"
          ]
        },
        "youtube-transcript": {
          "command": "npx",
          "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
        }
      }
    }
    JSON

    파일을 저장하고, 클로드를 재시작해주세요.

    Youtube Transcript MCP 사용해보기

    이제 클로드에게 유튜브 링크를 전달해주면, 알아서 자막을 분석해 원하는 대답을 해줍니다.

    영상 링크와 함께 평소 제가 글쓰는 스타일을 참고해 이에 맞추어 글을 작성해달라고 요청해보았습니다.
    유튜브 글쓰기

    꽤나 잘 작성해줍니다.
    다음 블로그 글 작성도 맡겨 볼 수 있겠습니다.

    마치며

    오늘 소개한 것 외에도 정말 다양한 기능의 MCP 서버가 존재합니다.

    Blender MCP를 사용하면 AI를 이용해 3D 모델링을 할 수 있고요.
    엑셀, 노션, 에이블톤등 다양한 소프트웨어와 연동할 수 있는 MCP 서버도 많습니다.

    포켓몬 MCP를 활용해 AI가 포켓몬에 대한 정보를 따로 찾아보고 학습하도록 만들 수도 있고요.

    나온 지 얼마 안된 기술이니만큼, 매일매일 새로운 MCP 서버가 활발하게 개발되고 있습니다.

    여러 MCP 서버를 모아서 볼 수 있는 사이트도 많습니다.

    둘러보시고 필요에 맞는 MCP 서버를 찾아 설정해보시면 되겠습니다.

    오늘 사용한 클로드 외에도 다른 AI 모델이나 프로그램과 연동도 가능합니다.
    ChatGPT에서도 곧 MCP 서버를 사용할 수 있게 될 예정이라고 하고요.
    코드 편집기인 CursorZed, 심지어는 Neovim에서도 이러한 연동을 도와주는 플러그인이 존재합니다.

    저도 클로드와 Neovim에 MCP 서버를 연결해 이것저것 다양하게 시도해보고있는데요.
    기회가 되면 MCP 서버를 직접 만들어보아도 재밌을 것 같습니다.

    도움이 되었길 바랍니다.

    감사합니다.