MCP 프록시 서버에 연결됨

📋 개요

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

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

Related MCP server: mcp-server-collector

✨ 주요 특징

범용 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 구성에 다음을 추가하세요.

{ "mcpServers": { "pluggedin": { "command": "npx", "args": ["-y", "@pluggedin/mcp-proxy@latest"], "env": { "PLUGGEDIN_API_KEY": "YOUR_API_KEY" } } } }

클라인

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

{ "mcpServers": { "pluggedin": { "command": "npx", "args": ["-y", "@pluggedin/mcp-proxy@latest"], "env": { "PLUGGEDIN_API_KEY": "YOUR_API_KEY" } } } }

커서

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

npx -y @pluggedin/mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY

⚙️ 구성 옵션

환경 변수

변하기 쉬운	설명	필수의	기본
`PLUGGEDIN_API_KEY`	plugged.in 앱의 API 키	예	-
`PLUGGEDIN_API_BASE_URL`	plugged.in 앱의 기본 URL	아니요	`https://plugged.in`

명령줄 인수

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

npx -y @pluggedin/mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY --pluggedin-api-base-url https://your-custom-url.com

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

npx -y @pluggedin/mcp-proxy@latest --help

🐳 Docker 사용법

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

이미지 구축

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

docker build -t pluggedin-mcp-proxy:latest .

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

컨테이너 실행

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

docker run -it --rm \ -e PLUGGEDIN_API_KEY="YOUR_API_KEY" \ -e PLUGGEDIN_API_BASE_URL="YOUR_API_BASE_URL" \ --name pluggedin-mcp-container \ pluggedin-mcp-proxy:latest

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

MCP Inspector로 테스트

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

npx @modelcontextprotocol/inspector docker://pluggedin-mcp-container

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

컨테이너 중지

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

🏗️ 시스템 아키텍처

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

sequenceDiagram participant MCPClient as MCP Client (e.g. Claude Desktop) participant PluggedinMCP as plugged.in MCP Proxy participant PluggedinApp as plugged.in App participant MCPServers as Underlying MCP Servers MCPClient ->> PluggedinMCP: Request list tools/resources/prompts PluggedinMCP ->> PluggedinApp: Get capabilities via API PluggedinApp ->> PluggedinMCP: Return capabilities (prefixed) MCPClient ->> PluggedinMCP: Call tool/read resource/get prompt alt Standard capability PluggedinMCP ->> PluggedinApp: Resolve capability to server PluggedinApp ->> PluggedinMCP: Return server details PluggedinMCP ->> MCPServers: Forward request to target server MCPServers ->> PluggedinMCP: Return response else Custom instruction PluggedinMCP ->> PluggedinApp: Get custom instruction PluggedinApp ->> PluggedinMCP: Return formatted messages end PluggedinMCP ->> MCPClient: Return response alt Discovery tool MCPClient ->> PluggedinMCP: Call pluggedin_discover_tools PluggedinMCP ->> PluggedinApp: Trigger discovery action PluggedinApp ->> MCPServers: Connect and discover capabilities MCPServers ->> PluggedinApp: Return capabilities PluggedinApp ->> PluggedinMCP: Confirm discovery complete PluggedinMCP ->> MCPClient: Return discovery result end

🔄 워크플로

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

🧩 plugged.in 앱과 통합

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

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

📚 관련 자료

🤝 기여하기

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

📄 라이센스

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

🙏 감사의 말

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

pluggedin-mcp-proxy