MCPファイルシステムサーバーとは？

MCPファイルシステムサーバーは、Model Context Protocol（MCP）に互換性のあるカスタムサーバーで、ローカルファイルシステムを通じてファイルの検索と管理を行うことができます。OpenAIのAgent SDKと統合されており、リソースリストの取得とファイルの開く操作をサポートしています。

MCPファイルシステムサーバーの使い方は？

まずサーバーをインストールし、次にサービスを起動して対象ディレクトリを設定します。Agent SDKを通じてAPIインターフェースを呼び出すことで、ファイルの検索と管理を実現できます。

適用シナリオ

ローカルファイルを迅速にアクセスする必要がある開発者、研究者、およびチーム協働環境に適しています。

主な機能

ファイル検索指定されたディレクトリ内で効率的なファイル検索をサポートします。

自動MIMEタイプ検出ファイルタイプを自動的に識別し、後続の処理を容易にします。

柔軟な設定環境変数を通じてサーバーの設定を簡単に調整できます。

JSON - RPCプロトコルサポートJSON - RPC標準に準拠し、通信の安定性を確保します。

利点と制限

利点

複数のファイル操作をサポートし、ファイル管理プロセスを簡素化します。

主流のAgent SDKと互換性があり、容易に統合できます。

強力なMIMEタイプ検出能力を備え、ユーザー体験を向上させます。

制限

ローカルファイルシステムへのアクセスに限定され、ネットワークを越えた操作はできません。

大規模なファイルストレージに対してはパフォーマンスが制限される可能性があります。

使い方

サーバーのインストール

プロジェクトコードをクローンし、依存関係をインストールします。

サーバーの設定

.envファイルを編集し、検索ディレクトリ、ホストアドレス、およびログレベルを設定します。

サーバーの起動

メインプログラムを実行してMCPサーバーを起動します。

使用例

例1：ファイルの検索APIインターフェースを通じて対象ディレクトリ内のすべてのPDFドキュメントを検索します。

例2：ファイルの開くAgent SDKから指定されたファイルを開くように要求します。

よくある質問

デフォルトの検索ディレクトリを変更するにはどうすればいいですか？

サーバーの起動に失敗した場合はどうすればいいですか？

リモートアクセスはサポートされていますか？

🚀 月のMCPファイルシステムサーバー

MCP標準に準拠し、ローカルファイルシステムでのファイル検索を可能にするカスタムサーバーです。OpenAIのAgent SDKのresources/listメソッドを通じてリソースリストとのやり取りを実現します。

🚀 クイックスタート

このサーバーは、OpenAIのAgent SDKと統合され、MCPプロトコルを通じてローカルファイルシステム上でのファイル検索と開く操作をサポートします。以下の手順でサーバーを起動できます。

✨ 主な機能

MCPを通じてファイルシステムリソースを提供（ファイル検索と開く操作をサポート）
MIMEタイプを自動検出
環境変数を使用した柔軟な設定
JSON - RPCプロトコルをサポート

📦 インストール

リポジトリのクローンと依存関係のインストール

# リポジトリをクローン
git clone https://github.com/yuutotsuki/tsuki_mcp_filesystem_server.git
cd tsuki_mcp_filesystem_server

# 依存関係をインストール
pip install -r requirements.txt

📚 ドキュメント

設定

.env.example を .env にコピーして設定を行います。
```
cp .env.example .env
```

.env ファイルを必要に応じて編集します。

ROOT_PATH=/path/to/your/search/directory  # 検索対象のディレクトリパス
HOST=127.0.0.1                            # サーバーのホストアドレス
PORT=5001                                 # サーバーのポート番号
LOG_LEVEL=INFO                            # ログレベル（DEBUG / INFO / WARNING / ERROR）