1MCP - 모든 사람을 위한 하나의 MCP 서버

여러 MCP 서버를 하나로 집계하는 통합된 모델 컨텍스트 프로토콜 서버 구현입니다.

개요

1MCP(One MCP)는 AI 어시스턴트 사용 방식을 간소화하도록 설계되었습니다. 1MCP는 여러 클라이언트(Claude Desktop, Cherry Studio, Cursor, Roo Code, Claude 등)에 대해 여러 MCP 서버를 구성하는 대신, 다음과 같은 기능을 제공하는 단일 통합 서버를 제공합니다.

여러 MCP 서버를 하나의 통합 인터페이스로 집계합니다.
중복된 서버 인스턴스를 제거하여 시스템 리소스 사용량을 줄입니다.
다양한 AI 어시스턴트 간의 구성 관리를 간소화합니다.
AI 모델이 외부 도구 및 리소스와 상호 작용할 수 있는 표준화된 방식을 제공합니다.
서버를 다시 시작하지 않고도 동적 구성 재로딩을 지원합니다.
정상적인 종료 및 리소스 정리를 처리합니다.

빠른 시작

Claude Desktop에 이미 구성된 기존 MCP 서버를 Cursor가 사용할 수 있도록 하려면 다음 단계를 따르세요.

Claude Desktop 구성 파일을 사용하여 1MCP 서버를 실행합니다.

지엑스피1

커서 구성 파일( ~/.cursor/mcp.json )에 1MCP 서버를 추가합니다.

{
    "mcpServers": {
        "1mcp": {
            "type": "http",
            "url": "http://localhost:3050/sse"
        }
    }
}

즐겨보세요!

용법

npx 사용하여 서버를 직접 실행할 수 있습니다.

# Basic usage (starts server with SSE transport)
npx -y @1mcp/agent

# Use existing Claude Desktop config
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Use stdio transport instead of SSE
npx -y @1mcp/agent --transport stdio

# Show all available options
npx -y @1mcp/agent --help

사용 가능한 옵션:

--transport, -t : 전송 유형을 선택합니다("stdio" 또는 "sse", 기본값: "sse")
--config, -c : 특정 구성 파일을 사용합니다
--port, -P : SSE 포트 변경(기본값: 3050)
--host, -H : SSE 호스트 변경(기본값: localhost)
--tags, -g : 태그로 서버 필터링(아래 태그 섹션 참조)
--help, -h : 도움말 표시

환경 변수의 예:

# Using environment variables
ONE_MCP_PORT=3051 ONE_MCP_TAGS=network,filesystem npx -y @1mcp/agent

# Or in your shell configuration
export ONE_MCP_PORT=3051
export ONE_MCP_TAGS=network,filesystem
npx -y @1mcp/agent

도커

Docker를 사용하여 1MCP를 실행할 수도 있습니다.

# Pull the latest image
docker pull ghcr.io/1mcp-app/agent:latest

# Run with SSE transport (default)
docker run -p 3050:3050 ghcr.io/1mcp-app/agent

# Run with a custom config file
docker run -p 3050:3050 -v /path/to/config.json:/config.json ghcr.io/1mcp-app/agent --config /config.json

# Run with stdio transport
docker run -i ghcr.io/1mcp-app/agent --transport stdio

사용 가능한 이미지 태그:

latest : 최신 안정 릴리스
vX.YZ : 특정 버전(예: v1.0.0 )
sha-<commit> : 특정 커밋

환경 변수

ONE_MCP_ 로 시작하는 환경 변수를 사용하여 1MCP를 구성할 수 있습니다.

ONE_MCP_TRANSPORT : 전송 유형("stdio" 또는 "sse", 기본값: "sse")
ONE_MCP_PORT : SSE 포트(기본값: 3050)
ONE_MCP_HOST : SSE 호스트(기본값: "localhost")
ONE_MCP_CONFIG : 구성 파일 경로
ONE_MCP_TAGS : 서버를 필터링할 태그의 쉼표로 구분된 목록

환경 변수의 예:

docker run -p 3051:3051 \
  -e ONE_MCP_PORT=3051 \
  -e ONE_MCP_TAGS=network,filesystem \
  ghcr.io/1mcp-app/agent

태그 이해

태그를 사용하면 다양한 클라이언트에서 사용할 수 있는 MCP 서버를 제어할 수 있습니다. 태그는 각 서버가 수행할 수 있는 작업을 설명하는 레이블이라고 생각하면 됩니다.

태그 사용 방법

서버 구성에서 : 각 서버에 태그를 추가하여 해당 기능을 설명합니다.

{
  "mcpServers": {
    "web-server": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "tags": ["network", "web"],
      "disabled": false
    },
    "file-server": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "~/Downloads"],
      "tags": ["filesystem"],
      "disabled": false
    }
  }
}

stdio 모드에서 1MCP를 시작할 때 : 태그로 서버를 필터링할 수 있습니다.

# Only start servers with the "network" tag
npx -y @1mcp/agent --transport stdio --tags "network"

# Start servers with either "network" or "filesystem" tags
npx -y @1mcp/agent --transport stdio --tags "network,filesystem"

SSE 전송을 사용할 때 : 클라이언트는 특정 태그가 있는 서버를 요청할 수 있습니다.

{
    "mcpServers": {
        "1mcp": {
            "type": "http",
            "url": "http://localhost:3050/sse?tags=network"  // Only connect to network-capable servers
        }
    }
}

태그 예:

network : 웹 요청을 하는 서버용
filesystem : 파일 작업을 처리하는 서버용
memory : 메모리/스토리지를 제공하는 서버의 경우
shell : shell 명령을 실행하는 서버의 경우
db : 데이터베이스 작업을 처리하는 서버용

구성

글로벌 구성

서버는 글로벌 위치에서 구성을 자동으로 관리합니다.

macOS/Linux: ~/.config/1mcp/mcp.json
윈도우: %APPDATA%/1mcp/mcp.json

구성 파일 형식

{
  "mcpServers": {
    "mcp-server-fetch": {
      "command": "uvx",
      "args": [
        "mcp-server-fetch"
      ],
      "disabled": false
    },
    "server-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ],
      "disabled": false
    }
  }
}

작동 원리

시스템 아키텍처

요청 흐름

개발

종속성 설치:

pnpm install

서버를 빌드하세요:

pnpm build

자동 재빌드를 사용한 개발의 경우:

pnpm watch

서버를 실행합니다:

pnpm dev

디버깅

패키지 스크립트로 제공되는 MCP Inspector를 사용합니다.

pnpm inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

1MCP Server

Integrations