로컬 오픈소스 LLM을 MCP 서버에 연결하는 방법

클라우드 종속성이나 구독료 없이 즐겨 사용하는 대규모 언어 모델(LLM)을 모델 컨텍스트 프로토콜(MCP) 서버에 연결하고 싶으신가요? 제대로 찾아오셨습니다! Director CLI 도구를 사용하면 오픈 소스 도구를 활용하여 모든 LLM을 모든 MCP 서버에 로컬로 연결할 수 있습니다. 이 가이드에서는 Director 설정, MCP 프록시 구성, 그리고 Claude, Cursor 또는 VS Code와 같은 클라이언트에 연결하는 방법을 안내해 드립니다. 이 가이드를 마치면 자신의 기기에서 Hacker News를 쿼리하거나 Slack에 쉽게 게시할 수 있게 될 것입니다. 시작해 볼까요!

Director란 무엇이며, 왜 사용해야 할까요?

Director는 2025년 7월에 출시된 오픈 소스 CLI 도구로, LLM을 MCP 서버에 연결하는 과정을 간소화합니다. 2024년 11월 Anthropic이 선보인 MCP는 LLM을 외부 데이터 소스 및 도구에 연결하기 위한 표준화된 프로토콜로, 'AI를 위한 USB-C'와 같습니다. Hacker News에서 인기 기사를 가져오거나 Slack에 요약을 게시하든, Director는 로컬 MCP 프록시를 쉽게 설정하고 여러 서버와 클라이언트를 관리할 수 있도록 해줍니다. 무료이며 개인 정보 보호에 중점을 두며, AI 워크플로우를 제어하려는 개발자에게 완벽합니다. 시작할 준비가 되셨나요?

1단계: Director CLI 도구 설치

이제 여러분의 기기에서 Director를 실행해 봅시다. 빠르고 브라우저가 필요 없는 설정을 위해 npm을 통해 로컬로 설치하거나, 유연성을 위해 원래의 curl 방식을 사용할 수 있습니다.

옵션 1: npm을 통한 설치

1. 터미널 열기:

• 즐겨 사용하는 터미널(macOS, Linux 또는 Windows WSL2)을 실행합니다. Node.js 20+이 설치되어 있는지 확인합니다(nodejs.org).

2. Director 설치:

• 실행:

npm install -g @director.run/cli

이 명령은 Director CLI를 전역으로 설치합니다.

3. 게이트웨이 시작:

• Director의 게이트웨이를 시작합니다:

director serve

이 명령은 http://localhost:8080에서 로컬 서버를 시작합니다.

4. 스튜디오 열기:

• 브라우저에서 구성 인터페이스를 엽니다:

director studio

이 명령은 프록시 설정을 위한 Director UI를 실행합니다.

옵션 2: Curl을 통한 설치

1. Director 설치:

• 실행:

curl -LsSf https://director.run/install.sh | sh

이 명령은 최신 Director 바이너리를 가져와 PATH에 설정합니다.

2. 퀵스타트 시작:

• 구성 인터페이스를 시작합니다:

director quickstart

이 명령은 http://localhost:8080에서 브라우저 창을 엽니다.

전문가 팁: 브라우저가 열리지 않으면 터미널에서 URL을 확인하거나 http://localhost:8080으로 이동하세요. 포트 8080이 사용 중이 아닌지 확인하세요(`lsof -i :8080`).

2단계: MCP 프록시 서버 구성

Director의 브라우저 UI 또는 CLI를 사용하여 MCP 프록시 서버를 설정할 수 있습니다. 프록시는 중개자 역할을 하여 LLM 요청을 Hacker News 또는 Slack과 같은 MCP 서버로 라우팅합니다. 두 가지 방법을 모두 살펴보겠습니다.

옵션 1: 브라우저 UI를 통한 구성

1. 프록시 생성:

• Director 브라우저 인터페이스(http://localhost:8080)에서 프록시 서버 생성을 클릭합니다.
• 예를 들어, my-proxy와 같이 이름을 지정합니다. 이것은 MCP 서버와 클라이언트를 연결하는 허브가 됩니다.

2. MCP 서버 추가:

• 검색창에서 Hacker News MCP 서버를 검색합니다.
• 프록시에 추가를 클릭합니다. Hacker News는 추가 구성이 필요 없습니다. 바로 사용할 수 있습니다!

3. 저장 및 배포:

• 설정을 저장합니다. Director가 로컬에서 프록시를 실행합니다.

옵션 2: CLI를 통한 구성

1. 게이트웨이 시작:

• Director가 실행 중인지 확인합니다:

director serve

2. 프록시 생성:

• 실행:

director create my-first-proxy

이 명령은 my-first-proxy라는 이름의 프록시를 설정합니다.

3. MCP 서버 추가:

• Hacker News 서버(또는 fetch와 같은 다른 서버)를 추가합니다:

director add fetch --target=my-first-proxy

fetch 서버는 Hacker News와 유사한 간단한 테스트용 MCP 서버입니다.

4. 클라이언트 연결:

• 프록시를 MCP 클라이언트에 연결합니다:

director connect my-first-proxy --target=claude
director connect my-first-proxy --target=cursor

• 필요한 경우 수동 연결 세부 정보를 출력합니다:

director connect my-first-proxy

왜 Hacker News 또는 Fetch인가요? 이들은 데이터(예: 인기 기사)를 가져오는 도구를 노출하는 경량 MCP 서버로, 테스트에 매우 유용합니다.

3단계: MCP 클라이언트 연결

이제 LLM 클라이언트(Claude Desktop, Cursor 또는 VS Code)를 프록시에 연결해 봅시다. Claude Desktop을 예시로 사용하지만, 다른 클라이언트도 과정은 유사합니다.

1. Claude Desktop 실행:

• Claude Desktop을 열고 도구 섹션으로 이동합니다.
• Director를 검색하고 프록시(my-first-proxy 또는 my-proxy)를 선택합니다.
• director_my-first-proxy 아래에서 list_top_stories와 같은 Hacker News 또는 fetch 서버의 도구를 볼 수 있습니다.

2. 테스트하기:

• Claude Desktop에서 다음을 시도해 보세요:

내 MCP 서버를 사용하여 Hacker News의 인기 기사 목록을 알려줘.

• Claude는 Director를 통해 도구를 호출하고, 채팅에서 결과를 볼 수 있습니다. 터미널에서 도구 호출을 보여주는 Director 로그를 확인하세요.

무슨 일인가요? Director는 Claude의 요청을 MCP 서버로 라우팅하고, 데이터를 가져와 Claude에게 다시 보냅니다. 이 모든 과정은 로컬에서 오픈 소스로 이루어집니다.

4단계: 더 많은 MCP 서버 추가(Slack과 같은)

설정을 확장하고 싶으신가요? 프록시에 Slack MCP 서버를 추가해 봅시다. 추가 구성이 필요하지만 Director를 사용하면 매우 쉽습니다.

1. Director 접속:

• 브라우저 UI(http://localhost:8080) 또는 CLI를 사용합니다.
• 브라우저: 프록시(my-first-proxy)를 선택하고 MCP 서버 추가를 클릭합니다.
• CLI: 실행:

director add slack --target=my-first-proxy

2. Slack 구성:

• Slack은 인증이 필요합니다. Director는 다음을 요청합니다:
• API 토큰: api.slack.com/apps에서 chat:write 및 channels:read 스코프를 가진 Slack 봇 앱을 생성합니다.
• 채널 ID: 대상 채널을 지정합니다(예: #general).
• 브라우저 UI에서는 구성 필드에 이들을 입력합니다. CLI의 경우 플래그로 전달합니다:

director add slack --target=my-first-proxy --api-token=your-slack-token --channel-id=C123456

• 저장하거나 프록시에 추가를 누릅니다.

3. Claude Desktop에서 확인:

• Claude Desktop의 director_my-first-proxy 아래에 있는 도구 섹션을 새로 고칩니다.
• 새로운 Slack 도구(예: post_message)가 Hacker News 도구와 함께 나타납니다.
• 다음으로 테스트합니다:

Hacker News의 인기 기사 목록을 알려주고, 요약해서 Slack에 게시해 줘.

• Claude는 기사를 가져오고, 요약하여 Slack에 게시합니다. 확인을 위해 Director의 터미널 로그 또는 director logs my-first-proxy를 확인하세요.

Slack에 더 많은 구성이 필요한 이유? Slack의 MCP 서버는 외부 API와 상호 작용하므로 보안 토큰이 필요합니다. Director는 UI 또는 CLI를 통해 이를 원활하게 처리합니다.

5단계: 여러 서버 및 클라이언트로 확장

Director는 여러 MCP 서버와 클라이언트를 관리할 때 빛을 발합니다. 확장하는 방법은 다음과 같습니다:

• 더 많은 서버 추가:
• 브라우저 UI 또는 CLI를 사용하여 **GitHub MCP**(리포지토리 관리용) 또는 **MongoDB MCP**(데이터베이스 쿼리용)와 같은 서버를 추가합니다. CLI의 경우:

director add github --target=my-first-proxy --api-token=your-github-token

• Director의 UI는 필요한 모든 구성(예: API 키 또는 OAuth 토큰)을 안내합니다.
• 여러 클라이언트 연결:
• **Cursor** 또는 **VS Code**와 같은 추가 클라이언트를 연결합니다:

director connect my-first-proxy --target=cursor
director connect my-first-proxy --target=vscode

• **Cursor**의 경우, ~/.cursor/mcp.json에 추가합니다:

{
  "mcpServers": {
    "director_my-first-proxy": {
      "command": "director",
      "args": ["proxy", "my-first-proxy"]
    }
  }
}

• **VS Code**의 경우, 마켓플레이스에서 **Director MCP 확장**을 설치하고 my-first-proxy를 선택합니다.
• 프록시 관리:
• 다양한 프로젝트를 위한 별도의 프록시를 생성합니다(예: work-proxy, personal-proxy):

director create work-proxy

• 다음 명령으로 프록시 목록을 확인합니다:

director list-proxies

전문가 팁: 자세한 CLI 사용법은 CLI 참조를 확인하세요.

일반적인 문제 해결

• Director가 시작되지 않나요? 포트 8080이 사용 중이 아닌지(`lsof -i :8080`) 확인하고, npm 설치의 경우 Node.js가 설치되어 있는지 확인하세요. `director serve`를 다시 시도하세요.
• MCP 서버를 찾을 수 없나요? Director의 검색 인덱스에 서버가 있는지 확인하거나 오타를 확인하세요. 일부 서버는 초기 설정에 인터넷이 필요합니다.
• 인증 오류가 발생하나요? Director의 구성에서 API 키/토큰을 확인하세요. Slack의 경우 봇에 `chat:write` 권한이 있는지 확인하세요.
• 클라이언트가 도구를 볼 수 없나요? 클라이언트를 다시 시작하거나 Director에서 프록시를 전환하세요(`director restart my-first-proxy`).
• 응답이 느린가요? 로컬 MCP 서버는 하드웨어에 의존합니다. GitHub와 같은 복잡한 서버에는 16GB 이상의 RAM과 적절한 CPU를 사용하세요.

MCP 연결에 Director를 사용하는 이유?

Director는 로컬 AI 워크플로우를 위한 개발자의 꿈입니다. 다음은 그 이유입니다:

• 오픈 소스 파워: 1.8k+ GitHub 스타를 보유한 MIT 라이선스 Director는 투명하고 커뮤니티 주도적입니다.
• 개인 정보 보호 우선: 로컬에서 실행되어 데이터를 안전하게 유지합니다.
• 유연한 설정: UI 또는 CLI를 통해 여러 MCP 서버(Hacker News, Slack, GitHub) 및 클라이언트(Claude, Cursor, VS Code)를 지원합니다.
• 사용 편의성: 직관적인 인터페이스로 Slack의 OAuth와 같은 복잡한 구성을 간소화합니다.

사용자들은 Director의 다재다능함을 강조하며, Claude Code에 대해 "MCP 설정이 마법처럼 느껴진다"고 언급합니다. 당신이 개인 개발자이든 엔터프라이즈 AI를 구축하든, Director는 시간과 번거로움을 절약해 줍니다.

결론

이제 Director를 사용하여 모든 LLM을 모든 MCP 서버에 연결할 수 있게 되었습니다! Hacker News 기사를 가져오는 것부터 Slack 요약을 게시하는 것까지, 로컬에서 실행되는 오픈 소스 AI 강국이 여러분의 손끝에 있습니다. 더 많은 MCP 서버를 실험하고, 프록시를 조정하거나, 댓글로 설정을 공유해 보세요. AI 혁명을 로컬에서 오픈 소스로 유지합시다—즐거운 코딩 되세요!