지피터스 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 사용 결과 예제
클로드 데스크탑 앱 MCP 사용 결과 예제

결과와 배운 점

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

MCP 서버를 직접 구축하면 원하는 데이터를 MCP 호스트 앱에서 유연하게 활용할 수 있음
Cursor에서의 활용성이 특히 뛰어났음 (검색 → 문서 자동 정리까지 가능)
클로드는 직접적인 활용은 약간 제한적이지만, 기본 MCP 연동은 잘 동작
- 동일한 MCP 서버인데 응답 시간이 Cursor에 비해 느리고, 제대로 동작하지만 중간중간 MCP 서버 연결에 실패했다는 경고창이 뜸

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

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

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

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

도움 받은 글

참고 링크

📮 4만 5천 명이 받는 AI 뉴스레터 구독하기

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

소개

진행 방법

결과와 배운 점

도움 받은 글

이번 주 AI, 딱 쓸 것만