지피터스 MCP 서버 구축 및 연동 사례

소개

안녕하세요. 저는 지피터스에 얼마 전에 합류해서 데이터 관련 개발 업무를 하고 있는 엔지니어입니다.

제가 첫번째로 하고 있는 프로젝트는 지피터스 커뮤니티에 있는 방대한 AI 스터디 사례 글을 활용할 수 있도록 데이터 파이프라인 플랫폼을 구축하는 일입니다.

이번에 소개드릴 내용은 지피터스 커뮤니티의 다양한 사례 게시글의 일부를 임베딩 벡터화하고 이를 Pinecone 벡터 DB에 저장해서 검색할 수 있는 MCP 서버를 개발하고, 클로드 데스크탑 앱과 Cursor에 MCP 서버로 설정해서 지피터스 커뮤니티 지식을 검색해 활용할 수 있게한 사례입니다.

진행 방법

  • 활용한 도구

    • 개발툴 : Cursor IDE

    • 개발언어 : Python

    • 벡터 DB : Pinecone

    • MCP 라이브러리 : FastMCP

  • 워크플로우

    • 지피터스 커뮤니티 활용 사례 글 API를 통한 조회

    • 게시물을 벡터 DB에 저장하기 위한 적절한 포맷으로 변환

      • 이미지, 영상 처리, Chunking 처리

    • Pinecone 벡터 DB에 저장

    • 벡터 DB 검색 모듈 구현

    • 벡터 DB 검색 모듈을 MCP 서버로 Wrapping해서 구현

    • 클로드 데스크탑 앱과 Cursor에 MCP 서버 등록

  • 벡터 DB에 저장된 내용 일부

    • Pinecone 웹 콘솔 화면

      한국어 웹 사이트의 스크린 샷
  • MCP 설정 : 클로드 데스크탑 앱, Cursor 공통

    {
        "mcpServers": {
            "gpters-mcp": {
                "command": "/project_dir/.venv/bin/python",
                "args": [
                    "/project_dir/mcp_server.py"
                ],
                "env": {}
            }
        }
    }
  • Cursur MCP 설정 화면 캡쳐

  • 클로드 데스크탑 앱 MCP 설정 화면 캡쳐

  • Cursur MCP 사용 결과 예제

    Adobe Adobe Adobe Ad의 한국 버전 스크린 샷
  • 클로드 데스크탑 앱 MCP 사용 결과 예제

    컴퓨터 화면에서 한국어의 스크린 샷

결과와 배운 점

배운 점과 나만의 꿀팁을 알려주세요.

  • MCP 서버를 직접 구축하면 원하는 데이터를 MCP 호스트 앱에서 유연하게 활용할 수 있음

  • Cursor에서의 활용성이 특히 뛰어났음 (검색 → 문서 자동 정리까지 가능)

  • 클로드는 직접적인 활용은 약간 제한적이지만, 기본 MCP 연동은 잘 동작

    • 동일한 MCP 서버인데 응답 시간이 Cursor에 비해 느리고, 제대로 동작하지만 중간중간 MCP 서버 연결에 실패했다는 경고창이 뜸

과정 중에 어떤 시행착오를 겪었나요?

  • 현재 MCP 서버를 클로드 데스크탑 앱이나 Cursor IDE 같은 MCP 호스트 앱에 등록하는 방법은 크게 두가지가 있습니다. mcpServer로 등록하는 방법과 mcp tools로 등록하는 방법이 있는데, mcp tools로 등록하는 방법은 여러 번 시행착오를 거쳤지만 결국 실패해서 mcpServer 방식으로 등록했습니다.

앞으로의 계획이 있다면 들려주세요.

  • 지피터스 커뮤니티 활용 사례 전체 데이터로 확장하여 벡터 DB에 저장

도움 받은 글

참고 링크

9
6개의 답글

👉 이 게시글도 읽어보세요