MCP Filesystem

🚀 MCP ファイルシステムプロトコルサーバ

作業ディレクトリ内の各ファイルリソースを提供し、変更通知を送信するモデルコンテキストプロトコル (MCP) サーバです。

🚀 クイックスタート

このサーバは、作業ディレクトリ内の各ファイルのリソースを提供し、ファイルの変更を通知します。以下に、サーバのインストールと設定方法を説明します。

✨ 主な機能

• リソース：作業ディレクトリ内の各ファイルに対して MCP リソースを作成します。
• .gitignore サポート：.gitignore ルールを尊重します。
• 変更通知：ファイルの変更、追加、削除を検出し、通知します。
• MIME タイプ識別とエンコーディング処理：ファイルタイプを識別し、複数のテキストエンコーディングを処理します。

📦 インストール

Go のインストール

https://golang.org/doc/install の手順に従って、Go をインストールしてください。

サーバの取得または更新

go install github.com/isaacphi/mcp-filesystem@latest

クライアント設定ファイルの更新

Claude Desktop の場合は、~/Library/Application Support/Claude/claude_desktop_config.json に以下の内容を追加します。

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem",
      "args": ["--workspace", "/path/to/your/repository"]
    }
  }
}

/path/to/your/repository をプロジェクトの絶対パスに置き換えてください。

💻 使用例

基本的な使用法

クライアントは、作業ディレクトリ内のすべての非無視ファイルを MCP リソースとしてアクセスおよび参照できます。各ファイルは、適切な MIME タイプ検出を伴う独立したリソースとして登録されます。

クライアントの要件

クライアントは、以下の MCP 機能をサポートする必要があります。

• リソースリスト：サーバが公開するすべてのリソースをリストし、アクセスする機能
• 変更通知：notifications/resources/list_changed イベントを受信するサポート
• リソースコンテンツアクセス：リソースコンテンツとその適切な MIME タイプを要求し、表示する機能

📚 ドキュメント

サポート技術

このプロジェクトでは、以下の技術を使用しています。

• mark3labs/mcp-go：MCP 通信を提供します。
• fsnotify：ファイルシステムイベントを監視します。
• go-gitignore：.gitignore ファイルを解析します。

開発手順

リポジトリのクローン

git clone https://github.com/isaacphi/mcp-filesystem.git
cd mcp-filesystem

依存関係のインストール

go mod download

ビルド

go build

クライアントの設定

クライアントをローカルビルドバージョンを使用するように設定するには、以下の内容をクライアント設定ファイルに追加します。

{
  "mcpServers": {
    "filesystem": {
      "command": "/full/path/to/your/mcp-filesystem/mcp-filesystem",
      "args": ["--workspace", "/path/to/repository"],
      "env": {
        "DEBUG": "1"
      }
    }
  }
}

フィードバック

詳細な問題を報告する際は、関連するすべての情報を含めてください。詳細なログを有効にするには、DEBUG 環境変数を設定します。

"env": {
  "DEBUG": "1"
}

予定されている機能

• [x] 作業ディレクトリ内の各ファイルのリソース
• [x] .gitignore サポート
• [x] 変更通知
• [ ] より多くのクライアント (Claude Desktop) をサポートするための MCP プロトコルの標準化
• [ ] 行番号のサポートを設定可能にする
• [ ] リソース更新のサブスクリプション
• [ ] .gitignore 以外の追加の無視パターン
• [ ] 高頻度のファイル変更を処理するための遅延通知
• [ ] info, create, edit, delete ツール

🔧 技術詳細

状態

⚠️ プレベータ品質 ⚠️ 「私の環境では正常に動作します」。問題の報告を歓迎します ❤️