1MCP: 1mcp serve로 여러 MCP 서버를 집계하기

누구에게 맞나

1MCP는 여러 MCP 서버를 하나의 런타임으로 묶으려는 사람용이다. 공식은 1MCP is the unified MCP runtime, 1mcp serve aggregates your MCP servers라고 쓴다. CLI mode는 Codex, Claude, Cursor 및 similar tool-using agents에게 더 얇은 프록시 작업 흐름을 준다.

더 맞는 경우는 npm 패키지를 전역으로 설치할 수 있고, 공식 예대로 먼저 context7을 넣은 뒤 1mcp serve를 시작하는 것을 받아들이는 때다. 첫 시도는 읽기 전용 발견으로 1mcp instructions를 호출한다.

맞지 않는 경우: 아직 Node/npm이 없는데 설치를 건너뛰고 백엔드를 지어내거나, 첫 번에 1mcp run으로 확인하지 않은 도구를 실행하려는 것. 공식은 --args의 예시 JSON을 주지 않는다.

3분 만에 첫 시도 끝내기

전제: 이 기기에 npm이 있다. 공식 주 경로는 이 세 단계다. 다른 설치기로 바꾸지 말 것:

npm install -g @1mcp/agent
1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp serve

설치 위치는 전역 @1mcp/agent다. serve가 뜬 뒤 HTTP 클라이언트는 공식 조각대로 다음에 연결할 수 있다: http://127.0.0.1:3050/mcp?app=cursor

첫 호출은 1mcp instructions다. CLI mode for progressive discovery에 속하며 사용 설명을 가져온다. 1mcp run보다 위험이 낮다. 나타나지 않은 인자를 붙이지 말 것.

성공 신호: instructions 텍스트가 돌아와 inspect 또는 run을 어떻게 이어갈지 설명한다. 이 기기에서 집계 런타임을 올리고 예대로 npx로 @upstash/context7-mcp를 가져온다. 「네트워크 없음, 로컬 프로세스 없음」이 아니다.

serve가 뜨지 않으면 먼저 전역 1mcp 명령이 되는지, mcp add가 context7을 넣었는지 확인한다. 1mcp cli-setup --codex만 유일한 설치로 두지 말 것.

사용 사례

사례 1: 먼저 발견 설명을 읽는다. serve가 이미 돌 때 1mcp instructions를 실행한다. 돌아온 텍스트로 CLI 발견 통로가 되는지 확인한다. 이 단계에서 --args를 넘기지 말 것.

사례 2: 어떤 백엔드 안에 무엇이 있는지 본다. 공식은 1mcp inspect <server> 및 1mcp inspect <server>/<tool>을 쓴다. 공식 예의 context7에 대해 1mcp inspect context7을 실행한다. 성공 시 그 server의 도구 정보가 보인다. inspect에서 실제 도구 이름을 얻은 뒤에만 1mcp run <server>/<tool> --args를 고려한다. 원문에 JSON 견본이 없다. 첫 시도에 run하지 말 것.

사용 경계

1mcp serve는 추가한 MCP 서버를 집계하고 127.0.0.1:3050에서 HTTP를 낸다. app=cursor는 공식 예시 쿼리 문자열일 뿐이다. 그 클라이언트를 써야 한다는 뜻이 아니다.

1mcp cli-setup --codex는 CLI 모드의 다른 배선이지 두 번째 패키지 설치 통로가 아니다. 1mcp run은 백엔드 도구를 실제로 실행한다. 부작용은 집계된 서버에 달렸다. 공식에 통일 취소 경로는 없다. instructions, inspect, run 및 예의 context7 이외의 백엔드 이름을 지어내지 말 것.