1mcp-app/agent
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
여러 MCP 서버를 하나의 서버에 통합하는 통합 모델 컨텍스트 프로토콜(Model Context Protocol) 서버 구현입니다.
개요
1MCP는 통합 MCP 런타임입니다. 1mcp 서브는 MCP 서버를 집계하며, CLI 모드는 Codex, Claude, Cursor 등 유사한 도구 사용 에이전트를 위한 더 얇은 에이전트 대상 워크플로우를 추가합니다. 대부분의 MCP 구성은 결국 두 가지 유형의 스프롤에 부딪힙니다: - 구성 스프롤: 각 클라이언트는 자체 MCP 배선, 인증 선택, 필터링 규칙이 필요합니다. - 에이전트 스프롤: 자율 세션이 너무 많은 도구와 스키마를 처음부터 컨텍스트에 전달합니다. - 1mcp 서브는 여러 MCP 서버 앞에 하나의 집계된 런타임을 제공합니다. - CLI 모드는 에이전트가 명령어를 통해 점진적으로 도구를 발견하고, 검사하며, 실행할 수 있게 합니다. - 정적 서버는 시작 시 로드할 수 있으며, 템플릿 서버는 클라이언트별 또는 세션별 컨텍스트에서 생성됩니다. - 프리셋, 필터, 명령어 집계는 동일한 런타임을 클라이언트와 프로젝트 간에 적용할 수 있게 유지합니다. 이 페이지는 AI 에이전트 사용자에게 최적화되어 있습니다.
개요(AI 번역)
1MCP는 통합 MCP 런타임입니다. 1mcp serve는 MCP 서버를 집계하며, CLI 모드는 Codex, Claude, Cursor 등 유사한 도구 사용 에이전트를 위한 더 얇은 에이전트 페이스 워크플로우를 추가합니다.
왜 1MCP
대부분의 MCP 구성은 결국 두 가지 유형의 스프롤에 부딪힙니다:
- 구성 스프롤(configurations sprawl): 각 클라이언트는 자체 MCP 배선, 인증 선택, 필터링 규칙이 필요합니다.
- 에이전트 스프롤: 자율 세션이 너무 많은 도구와 스키마를 처음부터 맥락에 포함시킵니다.
1MCP는 다음을 모두 다룹니다:
1mcp serve는 여러 MCP 서버 앞에서 하나의 집계된 런타임을 제공합니다.- CLI 모드는 에이전트가
instructions,inspect,run를 통해 점진적으로 도구를 발견할 수 있게 합니다. - 정적 서버는 시작 시 로드할 수 있으며, 템플릿 서버는 클라이언트별 또는 세션별 컨텍스트에서 생성됩니다.
- 프리셋, 필터, 명령어 집계는 동일한 런타임을 클라이언트와 프로젝트 간에 적용 가능하게 유지합니다.
| 접근 | 최선 | 트레이드오프 |
|---|---|---|
| 1MCP CLI 모드 | 코덱스, 클로드, 에이전트 루프 | 실행 중인 1mcp serve 인스턴스가 필요하다 |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
1MCP
1MCP is the unified MCP runtime. 1mcp serve aggregates your MCP servers, and CLI mode adds a thinner agent-facing workflow for Codex, Claude, Cursor, and similar tool-using agents.
Why 1MCP
Most MCP setups eventually hit two kinds of sprawl:
- Configuration sprawl: every client needs its own MCP wiring, auth choices, and filtering rules.
- Agent sprawl: autonomous sessions carry too many tools and schemas into context up front.
1MCP addresses both:
1mcp servegives you one aggregated runtime in front of many MCP servers.- CLI mode lets agents discover tools progressively with
instructions,inspect, andrun. - Static servers can load at startup, while template servers are created from per-client or per-session context.
- Presets, filters, and instruction aggregation keep the same runtime adaptable across clients and projects.
| Approach | Best for | Tradeoff |
|---|---|---|
| 1MCP CLI mode | Codex, Claude, agent loops | Requires a running 1mcp serve instance |
| 1MCP stdio proxy | Maximum compatibility across clients | Still depends on serve, and auth-capable HTTP clients have a more direct path |
| Direct streamable HTTP | MCP-native HTTP clients | No project context, no .1mcprc, and a broader tool surface is exposed directly |
| Custom proxying | One-off compatibility shims | You own discovery, filtering, auth, and runtime lifecycle |
Quick Start for Agent Users
This page is optimized for AI agent users. The 5-minute outcome is simple: start a real 1mcp serve runtime, connect your agent with cli-setup, then verify the instructions -> inspect -> run workflow.
You — setup: install 1MCP, add one upstream server, and start the runtime:
npm install -g @1mcp/agent설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"1mcp": {
"url": "http://127.0.0.1:3050/mcp?app=cursor"
}
}
}