local-only server

The server can only run on the client’s local machine because it depends on local resources.

MCP 서버

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

파일 찾기 MCP - 파일 검색용
Whisper STT MCP - 음성을 텍스트로 변환

파일 찾기 MCP 서버

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

필수 조건

Node.js(버전 14 이상)
npm(버전 6 이상)
Python 3.6 이상(HTTP 서버용)

설치

이 저장소를 복제하거나 다운로드하세요
프로젝트 디렉토리로 이동
종속성 설치:지엑스피1
프로젝트를 조립하세요:
npm run build

서버 시작

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

옵션 1: MCP 서버 직접 실행

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

npm start

또는

node build/index.js

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

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

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

먼저 HTTP 서버를 시작합니다.
npm run start:python
또는
python main.py
그런 다음 다른 터미널에서 MCP 프록시를 실행합니다.
npm run start:http
또는
node build/index-http.js

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

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

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
설정 파일의 mcpServers 개체에 다음 구성을 추가합니다.

"file-finder-mcp": {
  "command": "node",
  "args": ["<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ>/build/index.js"],
  "disabled": false,
  "autoApprove": []
}

HTTP 프록시를 사용하려면:

"file-finder-mcp-http": {
  "command": "node",
  "args": ["<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ>/build/index-http.js"],
  "disabled": false,
  "autoApprove": []
}

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

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

사용 가능한 도구

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

search_files : 이름에 지정된 조각이 포함된 파일을 검색합니다.
- 매개변수:
  - fragment (문자열, 필수): 파일 이름에서 검색할 텍스트 조각

사용 예

<use_mcp_tool>
<server_name>file-finder-mcp</server_name>
<tool_name>search_files</tool_name>
<arguments>
{
  "fragment": ".py"
}
</arguments>
</use_mcp_tool>

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

HTTP 서버(main.py)

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

HTTP 서버 시작

프로젝트의 루트 디렉토리로 이동하세요
Python을 사용하여 서버를 시작합니다.
python main.py
서버는 http://localhost:8080 에서 시작됩니다.

API 사용

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

http://localhost:8080/search?q=.json

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

name : 파일 이름
path : 파일의 절대 경로
size : 파일 크기(바이트)
created : 파일 생성 날짜 및 시간

답변 예시:

[
    {
        "name": "package.json",
        "path": "/absolute/path/to/package.json",
        "size": 1234,
        "created": "Wed Feb 26 17:00:00 2025"
    }
]

위스퍼 STT MCP 서버

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

필수 조건

Node.js(버전 14 이상)
npm(버전 6 이상)
Python 3.6 이상
faster-whisper ( pip install faster-whisper 로 설치)

설치

이 저장소를 복제하거나 다운로드하세요
프로젝트 디렉토리로 이동
종속성 설치:
npm install pip install faster-whisper
프로젝트를 조립하세요:
npm run build

서버 시작

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

옵션 1: MCP 서버 직접 실행

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

npm run start:whisper

또는

node build/whisper-index.js

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

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

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

먼저 HTTP 서버를 시작합니다.
npm run start:whisper:python
또는
python whisper_server.py
그런 다음 다른 터미널에서 MCP 프록시를 실행합니다.
npm run start:whisper:http
또는
node build/whisper-index-http.js

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

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

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
설정 파일의 mcpServers 개체에 다음 구성을 추가합니다.

"whisper-stt-mcp": {
  "command": "node",
  "args": ["<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ>/build/whisper-index.js"],
  "disabled": false,
  "autoApprove": []
}

HTTP 프록시를 사용하려면:

"whisper-stt-mcp-http": {
  "command": "node",
  "args": ["<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ>/build/whisper-index-http.js"],
  "disabled": false,
  "autoApprove": []
}

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

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

사용 가능한 도구

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

transcribe_audio : faster-whisper를 사용하여 오디오 데이터를 텍스트로 변환합니다.
- 매개변수:
  - audio_base64 (문자열, 필수): base64 형식의 오디오 데이터
  - language (문자열, 선택 사항): 언어 코드(예: "en", "ru"). 지정하지 않으면 언어가 자동으로 감지됩니다.

사용 예

<use_mcp_tool>
<server_name>whisper-stt-mcp</server_name>
<tool_name>transcribe_audio</tool_name>
<arguments>
{
  "audio_base64": "BASE64_ENCODED_AUDIO_DATA",
  "language": "ru"
}
</arguments>
</use_mcp_tool>

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

HTTP 서버(whisper_server.py)

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

HTTP 서버 시작

프로젝트의 루트 디렉토리로 이동하세요
Python을 사용하여 서버를 시작합니다.
python whisper_server.py
서버는 http://localhost:8081 에서 시작됩니다.

API 사용

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

audio : 오디오 데이터를 포함하는 base64로 인코딩된 문자열
language (선택 사항): 언어 코드(예: "en", "ru")

요청 예시:

{
  "audio": "BASE64_ENCODED_AUDIO_DATA",
  "language": "ru"
}

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

text : 전체 필사본 텍스트
segments : 타임스탬프가 있는 세그먼트 배열
language : 특정 언어
language_probability : 언어를 감지할 확률

답변 예시:

{
  "text": "Это пример транскрибированного текста.",
  "segments": [
    {
      "start": 0.0,
      "end": 2.5,
      "text": "Это пример"
    },
    {
      "start": 2.5,
      "end": 4.0,
      "text": "транскрибированного текста."
    }
  ],
  "language": "ru",
  "language_probability": 0.98
}

문제 해결

"서버에 대한 연결을 찾을 수 없습니다" 오류가 발생하면 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 - 프로젝트 문서(이 파일)

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

search_files

VS Code 등 다른 도구와 통합하거나 직접 사용할 수 있는 옵션을 제공하며, JSON-RPC나 HTTP REST API를 통해 이름 조각으로 파일을 검색할 수 있습니다.

Related Resources

Reddit Discussion about this server

File Finder MCP Server

MCP 서버

파일 찾기 MCP 서버

필수 조건

설치

서버 시작

옵션 1: MCP 서버 직접 실행

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

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

사용 가능한 도구

사용 예

HTTP 서버(main.py)

HTTP 서버 시작

API 사용

위스퍼 STT MCP 서버

필수 조건

설치

서버 시작

옵션 1: MCP 서버 직접 실행

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

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

사용 가능한 도구

사용 예

HTTP 서버(whisper_server.py)

HTTP 서버 시작

API 사용

문제 해결

프로젝트 구조

루트 디렉토리

Tools

Related Resources

Appeared in Searches