MCP-сервер для поиска файлов について
ファイルシステムをパスの一部で検索し、一致したファイル情報をJSONで返すPython製MCPサーバーです。READMEでは、VSCodeのClineで使う設定方法も説明しています。
主な機能
- 01パスの一部でファイル検索
- 02検索結果をJSONで返却
- 03ファイルのメタデータを提供
活用シーン
- 01部分的なパスからファイルを特定
- 02一致したファイル名とパスの取得
- 03ファイルサイズと作成日の確認
MCP 対応
ファイルシステムの検索結果をMCPクライアントに公開し、一致したファイルの情報をJSONで返します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
ファイル検索用 MCP サーバー
これは、パスの一部をもとにファイルシステム内のファイルを検索し、結果を JSON 形式で返す、Python で書かれたシンプルな MCP サーバーです。
インストール
- このリポジトリをクローンするか、スクリプト '
file_finder_mcp.py' をダウンロードします。 - システムに Python 3.x がインストールされていることを確認します。
サーバーの起動
- ターミナルを開き、'
file_finder_mcp.py' があるディレクトリに移動します。 - 次のコマンドを実行してサーバーを起動します。
python file_finder_mcp.py
説明
VSCode で Cline を設定し、ここで紹介する MCP サーバーと連携させる手順を説明します。まず、必要なコンポーネントをすべてインストールして設定します。
ステップ 1:VSCode のインストール
VSCode がインストールされていることを確認します。
ステップ 2:Cline 拡張機能のインストール
- VSCode を開きます。
- サイドバーから拡張機能(Extensions)を開くか、'
Ctrl+Shift+X' を押します。 - 検索欄に Cline と入力します。
- Cline 拡張機能を見つけてインストールします。
ステップ 3:Python のインストール
コンピューターに Python 3.x がインストールされていることを確認します。
ステップ 4:MCP サーバーの起動
'file_finder_mcp.py' ファイルをダウンロードするか作成します(サーバーのコードは上記に記載されています)。
VSCode でターミナル(Ctrl+`)を開くか、別のターミナルを使用します。
file_finder_mcp.py があるフォルダーに移動します。
次のコマンドでサーバーを起動します。
python file_finder_mcp.py
サーバーはポート 8080 で起動します。次のメッセージが表示されます。
Starting MCP server on port 8080...
ステップ 5:MCP サーバーと連携するための Cline の設定
VSCode で Cline の設定ファイルを開きます。ファイルがない場合は、プロジェクトの .vscode フォルダーに作成します。
パス:'.vscode/cline-config.json'
MCP サーバーの設定を追加します。
{
"mcpServers": {
"file-finder-mcp": {
"args": [
"python",
"file_finder_mcp.py"
],
"command": "python",
"autoApprove": [],
"disabled": false
}
}
}
設定項目:
- '
command':サーバーの起動コマンド(python)。 - '
args':サーバーの起動引数(ファイル file_finder_mcp.py)。 - '
autoApprove':自動的に承認する操作のリスト(空のままにします)。 - '
disabled':false の場合、サーバーは有効になります。 設定ファイルを保存します。
ステップ 6:Cline を MCP サーバーに接続
設定の変更を適用するために、VSCode を再起動します。
MCP サーバーが起動していることを確認します(ステップ 4 を参照)。
VSCode で Cline パネルを開きます(自動的に開いていない場合)。
Cline は 'cline-config.json' の設定を使用して、MCP サーバーに自動的に接続されます。
ステップ 7:リクエストとレスポンスの例
curl "http://localhost:8080/?path=example"
または、Postman がインストールされている場合は、「GET」リクエストを送信します。
http://localhost:8080/?path=readme
[
{
"name": "readme.markdown",
"path": "/AdobePhotoshop\\Adobe\\Adobe Photoshop CC 2019\\Required\\Generator-builtin\\node_modules\\optimist\\readme.markdown",
"size": 11208,
"creation_date": "2019-10-17 15:25:58"
},
{
"name": "readme.markdown",
"path": "/AdobePhotoshop\\Adobe\\Adobe Photoshop CC 2019\\Required\\Generator-builtin\\node_modules\\optimist\\node_modules\\minimist\\readme.markdown",
"size": 1712,
"creation_date": "2019-10-17 15:25:58"
},
{
"name": "readme.txt",
"path": "/AdobePhotoshop\\Adobe\\Adobe Photoshop CC 2019\\Required\\Linguistics\\Providers\\Plugins2\\AdobeHunspellPlugin\\dictionaries\\tr_TR\\readme.txt",
"size": 362,
"creation_date": "2019-10-17 15:56:44"
},
{
"name": "readme.md",
"path": "/AdobePhotoshop\\Adobe\\Adobe Photoshop CC 2019\\Required\\Plug-ins\\Generator\\assets.generate\\node_modules\\os-tmpdir\\readme.md",
"size": 725,
"creation_date": "2019-10-17 15:25:58"
},
]
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。