유튜브 MCP 서버

• 유튜브 MCP 서버

  • 에 대한

  • MCP란 무엇인가요?

  • 이 서버는 무슨 역할을 하나요?

  • 실제 사용 사례

  • 필수 조건

  • 설치

  • 구성

    • 클로드 데스크톱 구성

  • 개발

    • 시작하기

    • Inspector에서 서버 디버깅

  • 문제 해결

    • 'MCP 서버 mcp-youtube에 연결할 수 없습니다' 메시지

에 대한

이 서버는 Youtube API와 AI 어시스턴트를 연결하는 브리지 역할을 하며 Model Context Protocol을 기반으로 합니다.

Related MCP server: YouTube Comment Downloader MCP Server

MCP란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 Claude Desktop과 같은 AI 앱이 외부 도구 및 데이터 소스에 연결할 수 있도록 하는 시스템입니다. AI 어시스턴트가 사용자의 제어권을 유지하면서 로컬 서비스 및 API를 사용할 수 있는 명확하고 안전한 방법을 제공합니다.

이 서버는 무슨 역할을 하나요?

• [x] 주어진 비디오에 대한 닫힌 자막을 다운로드합니다.

실제 사용 사례

• [x] 영상 요약을 작성하세요

필수 조건

• uv

설치

지엑스피1

구성

클로드 데스크톱 구성

Claude Desktop이 Youtube MCP 서버를 인식하도록 구성합니다.

1. Claude Desktop 구성 파일을 엽니다.

   • MacOS에서는 구성 파일이 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있습니다.

   • Windows에서 구성 파일은 %APPDATA%\Claude\claude_desktop_config.json 에 있습니다.

   참고: Claude Desktop 앱 설정 내부에서도 claude_desktop_config.json을 찾을 수 있습니다.

2. 서버 구성 추가

   { "mcpServers": { "mcp-youtube": { "command": "mcp-youtube", } } } }

개발

시작하기

1. 저장소를 복제합니다

2. 종속성을 설치하세요

   uv sync

3. 서버를 실행하세요

   uv run mcp-youtube --help

src/mcp_youtube/tools.py 파일에 도구를 추가할 수 있습니다.

새로운 도구를 추가하는 방법:

1. ToolArgs에서 상속되는 새 클래스를 만듭니다.

   class NewTool(ToolArgs): """Description of the new tool.""" pass

   클래스의 속성은 도구의 인수로 사용됩니다. 클래스 docstring은 도구 설명으로 사용됩니다.

2. 새 클래스에 대한 tool_runner 함수를 구현합니다.

   @tool_runner.register async def new_tool(args: NewTool) -> t.Sequence[TextContent | ImageContent | EmbeddedResource]: pass

   이 함수는 TextContent, ImageContent 또는 EmbeddedResource의 시퀀스를 반환해야 합니다. 이 함수는 비동기적이어야 하며 새 클래스의 단일 인수를 받아야 합니다.

3. 완료! 클라이언트를 다시 시작하면 새 도구를 사용할 수 있습니다.

검증은 Claude Desktop을 통해서나 도구를 직접 실행하여 수행할 수 있습니다.

Inspector에서 서버 디버깅

MCP 검사기는 멋진 UI를 사용하여 서버 디버깅을 지원하는 도구입니다. 실행하려면 다음 명령을 사용하세요.

문제 해결

'MCP 서버 mcp-youtube에 연결할 수 없습니다' 메시지

Claude Desktop에서 'MCP 서버 mcp-youtube에 연결할 수 없습니다'라는 메시지가 나타나면 서버 구성이 잘못되었다는 의미입니다.

다음을 시도해 보세요.

• 구성 파일에서 mcp-youtube 바이너리의 전체 경로를 사용하세요.