MCP 서버

이 저장소에는 두 개의 MCP(Model Context Protocol) 서버가 포함되어 있습니다.

1. 파일 찾기 MCP - 파일 검색용

2. Whisper STT MCP - 음성을 텍스트로 변환

파일 찾기 MCP 서버

이는 파일 검색 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. 이름에 지정된 텍스트 조각이 포함된 파일을 검색할 수 있습니다.

필수 조건

• Node.js(버전 14 이상)

• npm(버전 6 이상)

• Python 3.6 이상(HTTP 서버용)

설치

1. 이 저장소를 복제하거나 다운로드하세요

2. 프로젝트 디렉토리로 이동

3. 종속성 설치:

   지엑스피1

4. 프로젝트를 조립하세요:

   npm run build

서버 시작

이 프로젝트는 MCP 서버를 시작하기 위한 여러 가지 옵션을 제공합니다.

옵션 1: MCP 서버 직접 실행

Node.js를 사용하여 MCP 서버를 직접 실행할 수 있습니다.

또는

그러면 서버가 시작되고 stdin/stdout에서 JSON-RPC 요청을 수신합니다.

옵션 2: HTTP 서버 및 MCP 프록시 실행

이 옵션은 Python HTTP 서버와 HTTP 서버로 요청을 전달하는 MCP 프록시를 사용합니다.

1. 먼저 HTTP 서버를 시작합니다.

   npm run start:python

   또는

   python main.py

2. 그런 다음 다른 터미널에서 MCP 프록시를 실행합니다.

   npm run start:http

   또는

   node build/index-http.js

옵션 3: VS Code와의 통합(Cline 확장)

서버를 VS Code와 Cline 확장 프로그램과 통합하려면:

1. MCP 설정 파일을 찾으세요.

   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   • 리눅스: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. 설정 파일의 mcpServers 개체에 다음 구성을 추가합니다.

HTTP 프록시를 사용하려면:

<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ> 프로젝트 디렉토리의 실제 경로로 바꾸세요.

3. 업데이트된 설정을 로드하려면 VS Code를 다시 시작하세요.

사용 가능한 도구

MCP 서버는 하나의 도구를 제공합니다.

• search_files : 이름에 지정된 조각이 포함된 파일을 검색합니다.

  • 매개변수:

    • fragment (문자열, 필수): 파일 이름에서 검색할 텍스트 조각

사용 예

이 예제에서는 이름에 ".py"가 포함된 모든 파일을 찾습니다.

HTTP 서버(main.py)

프로젝트의 루트 디렉토리에는 파일 검색을 위한 HTTP 서버를 구현한 main.py 파일이 있습니다. 이 서버는 이름에 지정된 조각이 포함된 파일을 검색하기 위한 REST API를 제공합니다.

HTTP 서버 시작

1. 프로젝트의 루트 디렉토리로 이동하세요

2. Python을 사용하여 서버를 시작합니다.

   python main.py

3. 서버는 http://localhost:8080 에서 시작됩니다.

API 사용

파일을 검색하려면 q 쿼리 매개변수와 함께 /search 에 GET 요청을 보냅니다.

이 쿼리는 이름에 ".json"이 포함된 모든 파일에 대한 정보가 담긴 JSON 배열을 반환합니다. 각 배열 요소에는 다음 필드가 포함됩니다.

• name : 파일 이름

• path : 파일의 절대 경로

• size : 파일 크기(바이트)

• created : 파일 생성 날짜 및 시간

답변 예시:

위스퍼 STT MCP 서버

이는 faster-whisper 라이브러리를 사용하여 음성-텍스트 기능을 제공하는 MCP(Model Context Protocol) 서버입니다. 이 기능을 사용하면 자동 언어 감지 기능을 통해 오디오 데이터를 텍스트로 변환할 수 있습니다.

필수 조건

• Node.js(버전 14 이상)

• npm(버전 6 이상)

• Python 3.6 이상

• faster-whisper ( pip install faster-whisper 로 설치)

설치

1. 이 저장소를 복제하거나 다운로드하세요

2. 프로젝트 디렉토리로 이동

3. 종속성 설치:

   npm install pip install faster-whisper

4. 프로젝트를 조립하세요:

   npm run build

서버 시작

이 프로젝트는 Whisper MCP 서버를 실행하기 위한 여러 가지 옵션을 제공합니다.

옵션 1: MCP 서버 직접 실행

Node.js를 사용하여 MCP 서버를 직접 실행할 수 있습니다.

또는

그러면 서버가 시작되고 stdin/stdout에서 JSON-RPC 요청을 수신합니다.

옵션 2: HTTP 서버 및 MCP 프록시 실행

이 옵션은 Python HTTP 서버와 HTTP 서버로 요청을 전달하는 MCP 프록시를 사용합니다.

1. 먼저 HTTP 서버를 시작합니다.

   npm run start:whisper:python

   또는

   python whisper_server.py

2. 그런 다음 다른 터미널에서 MCP 프록시를 실행합니다.

   npm run start:whisper:http

   또는

   node build/whisper-index-http.js

옵션 3: VS Code와의 통합(Cline 확장)

서버를 VS Code와 Cline 확장 프로그램과 통합하려면:

1. MCP 설정 파일을 찾으세요.

   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings\cline_mcp_settings.json

   • 리눅스: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. 설정 파일의 mcpServers 개체에 다음 구성을 추가합니다.

HTTP 프록시를 사용하려면:

<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ> 프로젝트 디렉토리의 실제 경로로 바꾸세요.

3. 업데이트된 설정을 로드하려면 VS Code를 다시 시작하세요.

사용 가능한 도구

MCP 서버는 하나의 도구를 제공합니다.

• transcribe_audio : faster-whisper를 사용하여 오디오 데이터를 텍스트로 변환합니다.

  • 매개변수:

    • audio_base64 (문자열, 필수): base64 형식의 오디오 데이터

    • language (문자열, 선택 사항): 언어 코드(예: "en", "ru"). 지정하지 않으면 언어가 자동으로 감지됩니다.

사용 예

이 예제에서는 오디오가 러시아어라고 가정하고 오디오 데이터를 텍스트로 변환합니다.

HTTP 서버(whisper_server.py)

프로젝트의 루트 디렉토리에는 음성을 텍스트로 변환하는 HTTP 서버를 구현한 whisper_server.py 파일이 있습니다. 이 서버는 오디오 데이터를 텍스트로 변환하기 위한 REST API를 제공합니다.

HTTP 서버 시작

1. 프로젝트의 루트 디렉토리로 이동하세요

2. Python을 사용하여 서버를 시작합니다.

   python whisper_server.py

3. 서버는 http://localhost:8081 에서 시작됩니다.

API 사용

오디오를 필사하려면 JSON 본문을 포함하여 /transcribe 에 POST 요청을 보내세요.

• audio : 오디오 데이터를 포함하는 base64로 인코딩된 문자열

• language (선택 사항): 언어 코드(예: "en", "ru")

요청 예시:

답변에는 다음이 포함됩니다.

• text : 전체 필사본 텍스트

• segments : 타임스탬프가 있는 세그먼트 배열

• language : 특정 언어

• language_probability : 언어를 감지할 확률

답변 예시:

문제 해결

• "서버에 대한 연결을 찾을 수 없습니다" 오류가 발생하면 MCP 설정을 업데이트한 후 VS Code를 다시 시작하세요.

• 서버가 응답하지 않으면 MCP 설정의 경로가 올바르고 컴파일된 JavaScript 파일을 가리키는지 확인하세요.

• 서버를 사용하기 전에 npm run build 실행하여 서버가 올바르게 빌드되었는지 확인하세요.

• HTTP 프록시를 사용하려면 적절한 HTTP 서버가 실행 중인지 확인하세요(file-finder의 경우 포트 8080, whipped-stt의 경우 포트 8081).

• faster-whisper에 문제가 있는 경우 라이브러리가 올바르게 설치되었는지 확인하고 GPU를 사용하는 경우 GPU에서 작동하는 데 필요한 종속성이 있는지 확인하세요.

프로젝트 구조

주요 프로젝트 파일과 그 용도는 다음과 같습니다.

루트 디렉토리

• src/index.ts - TypeScript MCP 파일 검색 서버 소스 코드(직접 구현)

• src/index-http.ts - HTTP 파일 검색 서버용 TypeScript MCP 프록시의 소스 코드

• src/whisper-index.ts - TypeScript MCP 음성-텍스트 서버 소스 코드(직접 구현)

• src/whisper-index-http.ts - HTTP 음성-텍스트 서버용 TypeScript MCP 프록시의 소스 코드

• build/index.js - 파일 검색을 위한 MCP 서버의 컴파일된 JavaScript 코드

• build/index-http.js - 파일 검색을 위한 MCP 프록시의 컴파일된 JavaScript 코드

• build/whisper-index.js - 음성을 텍스트로 변환하기 위한 MCP 서버의 컴파일된 JavaScript 코드

• build/whisper-index-http.js - 음성을 텍스트로 변환하기 위한 MCP 프록시의 컴파일된 JavaScript 코드

• tsconfig.json - TypeScript 구성

• package.json - 패키지 및 종속성에 대한 설명

• main.py - 파일 검색을 위한 Python HTTP 서버

• whisper_server.py - 음성을 텍스트로 변환하는 Python HTTP 서버

• README.md - 프로젝트 문서(이 파일)