Install
npx @modelcontextprotocol/server-everything누구에게 맞나
MCP 클라이언트를 구현하거나 디버깅하며 프로토콜 기능을 한 바퀴 돌릴 테스트 서버가 필요한 사람. 명시적으로 「not intended to be a useful server」이며 MCP 프로토콜 특성을 exercise 하는 데만 쓴다. npx 로 @modelcontextprotocol/server-everything 를 띄울 수 있고 반환값이 업무 결과가 아닌 데모 데이터여도 받아들이는 사람에게 맞다. 프로덕션 스크레이프, 저장소, 검색 도구로 쓰지 말 것. 공식 페이지: https://github.com/modelcontextprotocol/servers/tree/main/src/everything
3 분 안에 첫 시도 마치기
공식 경로는 하나만: 기본 stdio.
전제: 로컬에 npx 가 있음. 클라이언트 구축자를 위한 테스트베드이며 최종 업무용이 아니다.
설치와 설정 위치: MCP 클라이언트에서 시작 명령을 이렇게 쓴다:
npx @modelcontextprotocol/server-everything
동등한 설정 조각은 command: npx, 인수는 -y 와 @modelcontextprotocol/server-everything.
낮은 위험 동작: 연결 후 클라이언트가 이 서버가 선언한 tools 를 나열하게 한 뒤, 목록의 첫 번째 tool 을 호출한다. 문서에 없는 도구 이름을 손으로 쓰지 말 것. 서버는 prompts, resources, sampling 도 구현한다. 클라이언트가 prompts 나 resources 를 나열했다면 첫 prompt 를 꺼내거나 resource 하나를 읽어도 된다. 이 호출의 목적은 클라이언트가 실제 tool / prompt / resource 왕복을 끝낼 수 있는지 검증하는 것이며 업무 작업을 끝내는 것이 아니다.
성공 신호: 클라이언트가 적어도 한 종류(tools, prompts 또는 resources)를 나열하고, 고른 한 번의 호출이 내용을 반환한다. 빈 목록이나 프로세스 즉시 종료는 미완료다. 실패하면 먼저 명령이 기본 stdio 인지, 폐기된 HTTP+SSE 가 아닌지 확인한다.
사용 사례
사례 1: tools 를 검증한다. 「It implements prompts, tools, resources, sampling, and more」에 대응. 테스트 클라이언트로 list tools → call tool 을 한 바퀴 돈다. 반환값은 자리 표시나 데모 페이로드일 수 있으며 클라이언트 파싱이 맞는지 판단하는 데만 쓴다. 증거에 어떤 tool 이름이나 매개변수도 없으므로 사례는 「목록에 실제로 나타난 tool 에 한 번 호출」에서 멈춘다.
사례 2: prompts, resources 또는 sampling 을 검증한다. 같은 능력 문장. 클라이언트가 prompt 하나를 꺼내거나 resource 하나를 읽게 한다. 클라이언트가 sampling 을 구현했다면 서버가 샘플링 흐름을 트리거하는지 관찰한다. 증거는 능력 범주만 짚었고 prompt 이름, resource URI, sampling 메시지 형식은 쓰지 않았다. 빠진 부분은 런타임에 클라이언트가 나열한 객체를 따른다. URI 를 지어내지 말 것.
사용 경계
이것은 테스트 서버이며 유용한 업무 서버가 아니다. 실제 고객 데이터에 쓰지 말고 안정적인 업무 의미도 기대하지 말 것.
HTTP+SSE Transport 는 2025-03-26 에 폐기되었다. 소스 디렉터리의 npm install 와 npm run start:sse 는 첫 시도 경로가 아니다.
공식 권장은 npx 기본 stdio. 어떤 tool 호출이 읽기 전용처럼 보여도 테스트 구현은 알림, 샘플링 요청, 데모 자원 쓰기를 할 수 있다. 부작용 제로로 보지 말 것. 클라이언트 명단도 호스팅 URL 도 없다.