MCP サーバー

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

1. ファイルファインダーMCP - ファイル検索用

2. Whisper STT MCP - 音声をテキストに変換する

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

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

前提条件

• Node.js (バージョン 14 以上)

• npm (バージョン6以上)

• Python 3.6 以上（HTTP サーバー用）

インストール

1. このリポジトリをクローンまたはダウンロードする

2. プロジェクトディレクトリに移動する

3. 依存関係をインストールします:

   npm install

4. プロジェクトを組み立てる:

   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 プロキシを使用します。

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

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

2. 設定ファイルの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": []
}

<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ>プロジェクト ディレクトリへの実際のパスに置き換えます。

3. 更新された設定を読み込むには、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サーバーの起動

1. プロジェクトのルートディレクトリに移動する

2. Python を使用してサーバーを起動します。

   python main.py

3. サーバーは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"
    }
]

Related MCP server: Everything Search MCP Server

ウィスパーSTT MCPサーバー

これは、faster-whisper ライブラリを使用して音声テキスト変換機能を提供するモデル コンテキスト プロトコル (MCP) サーバーです。自動言語検出により、音声データをテキストに転記できます。

前提条件

• 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 サーバーを直接実行できます。

npm run start:whisper

または

node build/whisper-index.js

これによりサーバーが起動し、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

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

2. 設定ファイルの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": []
}

<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ>プロジェクト ディレクトリへの実際のパスに置き換えます。

3. 更新された設定を読み込むには、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サーバーの起動

1. プロジェクトのルートディレクトリに移動する

2. Python を使用してサーバーを起動します。

   python whisper_server.py

3. サーバーは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 - プロジェクトドキュメント（このファイル）