Filesystem (Python)

🚀 MCP ファイルシステム Python

特定ディレクトリ内のファイルに対して安全な読み取り専用アクセスを提供する Model Context Protocol (MCP) サーバーです。

🚀 クイックスタート

この MCP サーバーは、特定ディレクトリ内のファイルに対して安全な読み取り専用アクセスを提供します。以下のセクションでは、インストール方法、使用方法、開発手順などを説明します。

✨ 主な機能

• file:// URI スキームを使用して、ファイルを MCP リソースとして公開します。
• MCP ツールを通じたファイル検索機能を提供します。
• .gitignore パターンを尊重します。
• パストラバーサル防止などのセキュリティ機能を備えています。
• MIME タイプ検出をサポートします。

📦 インストール

UV を使用してインストールします。

uv add mcp-filesystem-python

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

uv run src/filesystem/server.py /path/to/directory

📚 ドキュメント

Claude デスクトップとの統合

設定例

examples ディレクトリには、Claude デスクトップの設定例ファイルがあります。

• examples/claude_desktop_config.json：macOS/Linux 用
• examples/claude_desktop_config_windows.json：Windows 用

これらのファイルは以下の場所に配置する必要があります。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%AppData%\\Claude\\claude_desktop_config.json

注意事項

1. パスを実際のパスに置き換えてください。
2. macOS/Linux では正斜線（/）を、Windows では反斜線（\）を使用してください。
3. 相対パスではなく絶対パスを使用してください。

開発

1. リポジトリをクローンします。
2. 仮想環境を作成し、依存関係を同期するには uv sync を実行します。

📄 ライセンス

MIT