Tsuki MCP Filesystem Server

🚀 月の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

📚 ドキュメント

設定

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

   cp .env.example .env
   

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

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

使用方法

# サーバーを起動
python main.py

サーバーは指定されたホストとポートで起動し、MCPクライアントからのリクエストを待機します。

API エンドポイント

現在サポートされているメソッドは以下の通りです。

• resources/list：対象ディレクトリ内のファイルリストを取得

開発

もしコードを貢献したい場合は、以下のガイドラインに従ってください。

1. PEP 8 のプログラミングスタイルに従う
2. 新機能に適切なテストを追加する
3. Pull Requestを送信する前に、すべてのテストが通過することを確認する

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

👤 作者

[yuutotsukitocu]

🌟 貢献

Pull Requestの提出を歓迎します。重大な変更については、まずIssuesを開いて議論してからコードを提出してください。