빠른 시작 자동 MCP: Claude 데스크탑 및 커서 일체형

Name: Quick-start Auto MCP
Author: teddynote-lab

영어 | 한국어

소개

Quick-start Auto MCP는 Claude Desktop과 Cursor에서 Anthropic의 Model Context Protocol(MCP)을 쉽고 빠르게 등록하는 데 도움이 되는 도구입니다.

주요 장점:

빠른 설정 : 도구를 실행하고 생성된 JSON 파일을 복사/붙여넣기만 하면 Claude Desktop과 Cursor에 MCP 기능을 추가할 수 있습니다.
다양한 도구 제공 : 유용한 MCP 도구가 지속적으로 업데이트됩니다. 저희를 팔로우하고 스타를 눌러 나만의 도구 키트를 최신 상태로 유지하세요. :)

Related MCP server: Hello-MCP

특징

RAG(Retrieval Augmented Generation) - PDF 문서에 대한 키워드, 의미론적 검색 및 하이브리드 검색 기능
Dify 외부 지식 API - Dify의 외부 지식 API를 통한 문서 검색 기능
Dify Workflow - Dify Workflow에서 실행 및 결과 검색
웹 검색 - Tavily API를 사용한 실시간 웹 검색
자동 JSON 생성 - Claude Desktop 및 Cursor에 필요한 MCP JSON 파일을 자동으로 생성합니다.

프로젝트 구조

지엑스피1

요구 사항

파이썬 >= 3.11
Claude Desktop 또는 Cursor(MCP 지원 버전)
uv(권장) 또는 pip

설치

1. 저장소를 복제합니다.

git clone https://github.com/teddynote-lab/mcp.git cd mcp

2. 가상 환경 설정

uv 사용(권장)

# macOS/Linux uv venv uv pip install -r requirements.txt

# Windows uv venv uv pip install -r requirements_windows.txt

pip 사용하기

python -m venv .venv # Windows .venv\Scripts\activate pip install -r requirements_windows.txt # macOS/Linux source .venv/bin/activate pip install -r requirements.txt

3. PDF 파일 준비

RAG에 필요한 PDF 파일을 ./data 디렉토리에 준비해주세요.

구성

각 케이스를 실행하려면 .env 파일이 필요합니다. 루트 디렉터리에 있는 .env.example 파일에 필요한 환경 변수를 지정하고 파일 이름을 .env 로 변경하세요.

각 사례에 필요한 환경 변수를 구성하기 위한 사이트

용법

1. JSON 파일 생성

각 케이스 디렉토리에서 다음 명령을 실행하여 필요한 JSON 파일을 생성합니다.

# Activate virtual environment # Windows .venv\Scripts\activate # macOS/Linux source .venv/bin/activate # Navigate to example directory cd case1 # Generate JSON file python auto_mcp_json.py

2. Claude Desktop/Cursor에 MCP 등록

Claude Desktop 또는 Cursor 실행
MCP 설정 메뉴 열기
생성된 JSON 콘텐츠를 복사하여 붙여넣습니다.
저장하고 restart

참고 : Claude Desktop 또는 Cursor를 실행하면 MCP 서버도 자동으로 실행됩니다. 소프트웨어를 종료하면 MCP 서버도 종료됩니다.

문제 해결

일반적인 문제 및 해결 방법:

MCP 서버 연결 실패 : 서비스가 정상적으로 실행되고 포트 충돌이 없는지 확인하세요. 특히 case2를 적용할 때는 dify_ek_server.py 도 함께 실행해야 합니다.
API 키 오류 : 환경 변수가 올바르게 설정되었는지 확인하세요.
가상 환경 문제 : Python 버전이 3.11 이상인지 확인하세요.