local-only server

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

MCP サーバー

このリポジトリには、2 つの MCP (モデルコンテキストプロトコル) サーバーが含まれています。

ファイルファインダーMCP - ファイル検索用
Whisper STT MCP - 音声をテキストに変換する

ファイルファインダー MCP サーバー

これは、ファイル検索機能を提供するモデルコンテキストプロトコル (MCP) サーバーです。名前に指定したテキストフラグメントを含むファイルを検索できます。

前提条件

Node.js (バージョン 14 以上)
npm (バージョン6以上)
Python 3.6 以上（HTTP サーバー用）

インストール

このリポジトリをクローンまたはダウンロードする
プロジェクトディレクトリに移動する
依存関係をインストールします:
npm install
プロジェクトを組み立てる:
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
- Linux: ~/.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 サーバーは次の 1 つのツールを提供します。

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) サーバーです。自動言語検出により、音声データをテキストに転記できます。

前提条件

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
- Linux: ~/.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 サーバーは次の 1 つのツールを提供します。

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 本文を含む POST リクエストを/transcribeに送信します。

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、whisper-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

JSON-RPC または HTTP REST API を介して名前のフラグメントでファイルを検索できるようになります。直接使用したり、VS Code などの他のツールと統合したりするためのオプションがあります。

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