afiaabatool067-png/mcpx

mcpx은(는) 무엇을 하나요?

MCP 서버를 검색 및 실행이라는 2개의 도구로 축소하여 도구 스키마와 토큰 사용을 줄이고 에이전트 설정을 더 빠르게 합니다.

개요

mcpx는 MCP(Model Context Protocol) 서버들의 수많은 도구들을 단 두 개의 지능형 도구로 통합합니다:

• search: 자연어 쿼리를 기반으로 적절한 MCP 서버와 함수를 찾습니다.
• execute: 식별된 함수를 안전하게 호출하고 결과를 반환합니다.

이를 통해 AI 에이전트는 각 MCP 서버의 전체 도구 스키마를 로드할 필요가 없으므로 토큰 사용량이 크게 줄어들고 설정 속도가 빨라집니다.

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 MCP 호환 AI 에이전트

설치 및 사용법

필수 조건

• Node.js 18+
• MCP 서버가 설치 및 구성되어 있어야 함

설치

npm install -g mcpx

또는 프로젝트에 로컬로 설치:

npm install mcpx

구성

.mcpx.json 파일을 프로젝트 루트에 생성합니다:

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

사용 예시

AI 에이전트에게 다음과 같이 지시합니다:

"저장소에서 최근 커밋을 검색하고 요약해줘."

mcpx가 자동으로 다음을 수행합니다:

1. search 도구를 사용하여 적절한 서버(GitHub)와 함수(get_commits)를 식별합니다.
2. execute 도구를 사용하여 함수를 호출하고 결과를 반환합니다.

작동 방식

1. 도구 등록: mcpx는 search와 execute라는 두 개의 도구만 에이전트에 등록합니다.
2. 검색 단계: 에이전트가 작업을 요청하면 search 도구가 자연어를 분석하여 적절한 MCP 서버와 함수를 매핑합니다.
3. 실행 단계: execute 도구가 필요한 매개변수와 함께 대상 함수를 호출합니다.
4. 결과 반환: 함수 실행 결과가 에이전트에게 반환되어 최종 응답을 생성합니다.

이점

• 토큰 절약: 각 MCP 서버의 전체 도구 스키마를 로드하지 않습니다.
• 빠른 설정: 에이전트가 즉시 작업을 시작할 수 있습니다.
• 단순화된 인터페이스: 단 두 개의 도구만으로 모든 MCP 기능에 접근합니다.
• 확장성: 새 MCP 서버를 추가해도 도구 인터페이스는 변경되지 않습니다.

라이선스

MIT