pluggedin-mcp-proxy

MCP 프록시 서버에 연결됨

📋 개요

plugged.in MCP 프록시 서버는 여러 모델 컨텍스트 프로토콜(MCP) 서버를 단일 통합 인터페이스로 통합하는 강력한 미들웨어입니다. plugged.in 앱 에서 도구, 프롬프트 및 리소스 구성을 가져와 적절한 기반 MCP 서버로 요청을 지능적으로 라우팅합니다.

이 프록시는 plugged.in 생태계를 통해 고급 관리 기능을 제공하는 동시에 모든 MCP 클라이언트(Claude, Cline, Cursor 등)와 원활하게 통합할 수 있도록 해줍니다.

✨ 주요 특징

• 범용 MCP 호환성 : Claude Desktop, Cline 및 Cursor를 포함한 모든 MCP 클라이언트와 호환됩니다.
• 다중 서버 지원 : STDIO(명령줄) 및 WebSocket(HTTP 기반) MCP 서버를 모두 연결합니다.
• 네임스페이스 격리 : 조인된 MCP를 분리하고 적절한 접두사로 구성합니다.
• 다중 작업 공간 계층 : 한 번의 클릭으로 다양한 MCP 구성 세트 간 전환
• 간소화된 아키텍처 : 향상된 시작 시간과 감소된 복잡성을 갖춘 간소화된 코드베이스
• API 기반 프록시 : 직접 검색하는 대신 플러그인된 앱 API에서 기능을 가져옵니다.
• 전체 MCP 지원 : 도구, 리소스, 리소스 템플릿 및 프롬프트를 처리합니다.
• 사용자 지정 지침 : MCP 프롬프트로 포맷된 서버별 지침을 지원합니다.

🚀 빠른 시작

필수 조건

• Node.js 18+ (권장 v20+)
• plugged.in 앱의 API 키( plugged.in/api-keys 에서 받으세요)

설치

지엑스피1

MCP 클라이언트 구성

클로드 데스크탑

Claude Desktop 구성에 다음을 추가하세요.

클라인

Cline 구성에 다음을 추가하세요.

커서

커서의 경우 환경 변수 대신 명령줄 인수를 사용할 수 있습니다.

⚙️ 구성 옵션

환경 변수

명령줄 인수

명령줄 인수는 환경 변수보다 우선합니다.

전체 옵션 목록은 다음과 같습니다.

🐳 Docker 사용법

Docker를 사용하여 프록시 서버를 빌드하고 실행할 수도 있습니다.

이미지 구축

Docker가 설치되어 실행 중인지 확인하세요. pluggedin-mcp 디렉터리로 이동하여 다음을 실행하세요.

빌드 컨텍스트를 최적화하기 위해 .dockerignore 파일이 포함되었습니다.

컨테이너 실행

필요한 환경 변수를 제공하여 컨테이너를 실행합니다.

YOUR_API_KEY 와 YOUR_API_BASE_URL 바꾸세요(기본값인 https://plugged.in 사용하지 않는 경우).

MCP Inspector로 테스트

컨테이너가 실행되는 동안 MCP 검사기를 사용하여 컨테이너에 연결할 수 있습니다.

이는 실행 중인 컨테이너의 표준 입력/출력에 연결됩니다.

컨테이너 중지

docker run 실행 중인 터미널에서 Ctrl+C 누르세요. --rm 플래그는 컨테이너가 중지될 때 자동으로 제거되도록 합니다.

🏗️ 시스템 아키텍처

플러그인된 MCP 프록시 서버는 MCP 클라이언트와 여러 기본 MCP 서버 간의 브리지 역할을 합니다.

🔄 워크플로

1. 구성 : 프록시는 plugged.in 앱에서 서버 구성을 가져옵니다.
2. 기능 목록 : 프록시는 plugged.in 앱 API에서 검색된 기능을 가져옵니다.
   • tools/list : /api/tools 에서 가져오기(접두사가 붙은 이름 반환)
   • resources/list : /api/resources 에서 가져옴
   • resource-templates/list : /api/resource-templates 에서 가져옴
   • prompts/list : /api/prompts 및 /api/custom-instructions 에서 가져와 결과를 병합합니다.
3. 기능 확인 : 프록시는 대상 서버에 대한 기능을 확인합니다.
   • tools/call : 도구 이름에서 접두사를 구문 분석하고 내부 맵에서 서버를 조회합니다.
   • resources/read : /api/resolve/resource?uri=... 호출하여 서버 세부 정보를 가져옵니다.
   • prompts/get : 사용자 정의 명령어 접두사 또는 호출 /api/resolve/prompt?name=... 확인합니다.
4. 요청 라우팅 : 요청은 적절한 기본 MCP 서버로 라우팅됩니다.
5. 응답 처리 : 기본 서버의 응답이 클라이언트로 반환됩니다.

🧩 plugged.in 앱과 통합

plugged.in MCP 프록시 서버는 다음을 제공하는 plugged.in 앱 과 원활하게 작동하도록 설계되었습니다.

• MCP 서버 구성을 관리하기 위한 웹 기반 인터페이스
• 중앙 집중식 기능 검색(도구, 리소스, 템플릿, 프롬프트)
• 맞춤 지침 관리
• 다양한 구성 세트에 대한 다중 작업 공간 지원
• MCP 도구 테스트를 위한 대화형 놀이터
• 사용자 인증 및 API 키 관리

📚 관련 자료

• plugged.in 앱 저장소
• 모델 컨텍스트 프로토콜(MCP) 사양
• 클로드 데스크톱 문서
• 클라인 문서

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

• MCP 프록시 서버 에서 영감을 받음
• 모델 컨텍스트 프로토콜을 기반으로 구축됨