mcp-director

Claude Code를 위한 MCP 프로필 추천 및 관리용 경량 MCP 서버입니다.

문제점

Claude Code는 세션 시작 시 구성된 모든 MCP 서버를 로드합니다. 20개 이상의 MCP가 있으면 시작 속도가 느려지지만, 실제로는 세션당 2~3개만 사용하게 됩니다.

해결책

mcp-director는 항상 켜져 있는 유일한 MCP로 유지됩니다. 수행하려는 작업을 알려주면 적절한 MCP를 추천하고 .mcp.json 프로필을 전환해 줍니다.

설치

프로젝트의 .mcp.json에 mcp-director를 추가하세요(파일이 없으면 프로젝트 루트에 생성하세요):

{
  "mcpServers": {
    "mcp-director": {
      "command": "npx",
      "args": ["-y", "mcp-director"]
    }
  }
}

그런 다음 Claude Code 세션을 시작(또는 재시작)하세요. mcp-director를 MCP 도구로 사용할 수 있게 됩니다.

참고: 전역 설치는 필요하지 않습니다. npx가 자동으로 다운로드하고 실행합니다.

사용법

mcp-director가 구성된 상태로 Claude Code가 시작되면, Claude에게 자연스럽게 대화하세요:

1. 초기화 — 기존 MCP 가져오기

"init 도구 실행해줘"

이 명령은 현재 .mcp.json을 읽고 모든 MCP를 .mcp-director/catalog.json으로 가져와서 디렉터가 해당 MCP들을 인식하도록 합니다.

2. 추천 받기

"회의록을 만들고 싶어"

Claude가 recommend를 호출하여 관련 MCP(예: whisper, notebooklm-mcp)와 일치하는 프로필을 제안합니다.

"웹 조사가 필요해"

LLM 지원 매칭을 위해 smart 모드를 사용하세요:

"대시보드 구축을 위한 MCP를 추천해줘, smart 모드 사용"

3. 프로필 전환

"개발 프로필 적용해줘"

이 명령은 .mcp.json을 다시 작성하여 github, context7, playwright만 포함하도록 합니다. 백업은 .mcp.json.bak으로 저장됩니다.

"디자인 프로필이 어떤 모습일지 보여줘" (드라이런)

4. 세션 재시작

.mcp.json에 대한 변경 사항은 다음 Claude Code 세션 시작 시 적용됩니다.

5. 사용자 지정 프로필 생성

"filesystem과 sequential-thinking을 포함하는 'data-work'라는 프로필을 만들어줘"

"research 프로필에 exa를 추가해줘"

도구

프로필

기본 제공 프로필:

create_profile을 사용하여 나만의 프로필을 만드세요.

번들 카탈로그

16개의 인기 있는 MCP가 기본으로 포함되어 있습니다:

github playwright context7 memory filesystem sequential-thinking slack figma linear whisper notebooklm-mcp exa google-calendar screenpipe n8n-mcp

init을 실행하거나 .mcp-director/catalog.json을 편집하여 나만의 MCP를 추가하세요.

작동 원리

• 키워드, 카테고리 및 기능이 포함된 인기 MCP 번들 카탈로그

• init은 기존 MCP를 로컬 .mcp-director/catalog.json으로 가져옵니다.

• recommend는 작업 설명에 따라 MCP 점수를 매깁니다.

• apply_profile은 .mcp.json을 다시 작성합니다(백업 파일 .mcp.json.bak 생성).

• 디렉터는 항상 .mcp.json에 자신을 유지합니다.

라이선스

MIT