Repolode
Dicklesworthstone

Dicklesworthstone/ultimate_mcp_client

stdio, SSE, streaming-HTTP를 통해 AI 모델과 MCP 서버를 연결하는 대화형 CLI 및 웹 UI를 갖춘 비동기 Python 클라이언트입니다.

스타
171
포크
23
열린 이슈
0
마지막 커밋
8일 전

어떤 프로젝트인가요?

Ultimate MCP Client는 AI 모델이 외부 도구, 리소스, 프롬프트에 접근하는 방식을 표준화하는 Model Context Protocol(MCP)용 Python 클라이언트입니다. Anthropic SDK를 통해 Claude 모델을 로컬 stdio 프로세스로 실행되는 MCP 서버나 원격 SSE 및 streaming-HTTP 엔드포인트에 연결하고, 각 도구를 제공하는 서버로 도구 호출을 전달합니다.

프로젝트는 하나의 핵심 기능을 기반으로 두 가지 프런트엔드를 제공합니다. FastAPI, WebSockets, Alpine.js, DaisyUI로 만든 웹 UI와 Typer, Rich로 만든 CLI가 있으며, CLI에는 슬래시 명령, 실시간 TUI 대시보드, 일괄 질의 기능이 포함됩니다. 대화는 분기형 그래프로 저장되며, 분기를 만들고 체크아웃하거나 요약해 컨텍스트 한도에 맞출 수 있고 JSON으로 내보내거나 가져올 수도 있습니다.

서버 검색은 로컬 스크립트 디렉터리, Claude Desktop 설정 가져오기(WSL 경로 조정 포함), 원격 레지스트리, 로컬 네트워크의 mDNS, 선택적 포트 스캔을 지원합니다. 도구 결과는 카테고리별 TTL과 종속성 기반 무효화를 적용해 디스크에 캐시할 수 있으며, OpenTelemetry 메트릭과 트레이싱도 내장되어 있습니다.

핵심 기능

  • 01stdio, SSE, streaming-HTTP 전송을 통해 MCP 서버에 연결합니다.
  • 02실시간 채팅 스트리밍, 서버 관리, 대화 분기 시각화 기능을 갖춘 웹 UI입니다.
  • 03슬래시 명령, Markdown 렌더링, 실시간 TUI 대시보드를 지원하는 대화형 CLI입니다.
  • 04분기 만들기, 체크아웃, 요약, 가져오기, 내보내기를 지원하는 분기형 대화 그래프입니다.
  • 05로컬 디렉터리, Claude Desktop 설정, 원격 레지스트리, mDNS, 포트 스캔을 통해 서버를 검색합니다.
  • 06TTL 및 종속성 기반 무효화를 적용해 도구 결과를 캐시합니다.

활용 사례

  • 직접 클라이언트를 작성하지 않고 Claude에서 MCP 도구를 시험해 보는 경우.
  • 원시 JSON-RPC 로그와 서버별 stderr 로그를 사용해 로컬 MCP 서버를 테스트하고 디버깅하는 경우.
  • Claude를 로컬 및 원격 도구 서버에 연결하는 자체 호스팅 채팅 인터페이스를 실행하는 경우.
  • 대화를 분기하고 비교해 다른 대화 경로를 살펴보는 경우.

빠른 시작

  1. 1

    uv 설치 (README의 공식 설치 스크립트 실행)

  2. 2

    저장소 클론

    git clone https://github.com/Dicklesworthstone/ultimate_mcp_client
  3. 3

    종속성 설치 (Python 3.13 이상 필요)

    uv sync --all-extras
  4. 4

    Web UI 실행 (먼저 ANTHROPIC_API_KEY 설정)

    mcpclient run --webui

사용 전 알아둘 점

  • Python 3.13 이상이 필요합니다.
  • Claude 모델을 사용하려면 Anthropic API 키가 필요합니다.
  • 라이선스가 비표준(MIT에 OpenAI/Anthropic 추가 조항 포함)으로 표시되어 있으므로, 상업적으로 사용하기 전에 조건을 확인하세요.

토픽

자주 묻는 질문

ultimate_mcp_client은(는) 무엇인가요?
stdio, SSE, streaming-HTTP를 통해 AI 모델과 MCP 서버를 연결하는 대화형 CLI 및 웹 UI를 갖춘 비동기 Python 클라이언트입니다. Ultimate MCP Client는 AI 모델이 외부 도구, 리소스, 프롬프트에 접근하는 방식을 표준화하는 Model Context Protocol(MCP)용 Python 클라이언트입니다. Anthropic SDK를 통해 Claude 모델을 로컬 stdio 프로세스로 실행되는 MCP 서버나 원격 SSE 및 streaming-HTTP 엔드포인트에 연결하고, 각 도구를 제공하는 서버로 도구 호출을 전달합니다.
ultimate_mcp_client은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ultimate_mcp_client은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ultimate_mcp_client은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ultimate_mcp_client의 마지막 커밋은 2026년 10월 14일입니다.
ultimate_mcp_client은(는) 어디에 사용할 수 있나요?
직접 클라이언트를 작성하지 않고 Claude에서 MCP 도구를 시험해 보는 경우. 원시 JSON-RPC 로그와 서버별 stderr 로그를 사용해 로컬 MCP 서버를 테스트하고 디버깅하는 경우. Claude를 로컬 및 원격 도구 서버에 연결하는 자체 호스팅 채팅 인터페이스를 실행하는 경우. 대화를 분기하고 비교해 다른 대화 경로를 살펴보는 경우.
ultimate_mcp_client는 어떻게 설치하나요?
uv 설치 (README의 공식 설치 스크립트 실행) 저장소 클론: git clone https://github.com/Dicklesworthstone/ultimate_mcp_client 종속성 설치 (Python 3.13 이상 필요): uv sync --all-extras Web UI 실행 (먼저 ANTHROPIC_API_KEY 설정): mcpclient run --webui
ultimate_mcp_client은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Dicklesworthstone/ultimate_mcp_client

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트