MCP Filesystem Server

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

免責事項：これは、Claude のファイルシステム MCP サーバー実装を非公式に移植したものであり、概念実証（POC）の目的のみで作成されています。このプロジェクトは Anthropic とは無関係であり、本番環境では使用しないでください。MCP サーバーの機能を実演し、調査するために作成されました。

元の実装とコンセプトは、対話セッション中に Claude（Anthropic）によって実演されました。この移植版は、教育目的でのみ提供されています。

クイックスタート

1. UVX を使用してインストールします：

uv venv
.venv\Scripts\activate  # On Windows
uv pip install -e .

Claude Desktop での使用方法

1. claude_desktop_config.json を編集します：

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"  // Replace with your desired directory
      ]
    }
  }
}

複数のディレクトリを追加できます：

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/",
        "C:/Users/YourUsername/Documents",
        "~/Desktop"
      ]
    }
  }
}

2. Claude Desktop を再起動して変更を適用します

3. Claude Desktop で：

   • クリップのアイコンをクリックします
   • MCP メニュー（2 つのプラグが接続されているアイコン）を選択します
   • ファイルシステムサーバーが連携機能に表示されます

セキュリティに関する注意

args 配列で指定したディレクトリのみアクセスできます。サーバーは、許可されたディレクトリの外部へのアクセスを防ぐため、厳格なパス検証を行います。

トラブルシューティング

1. コマンドが見つからない場合：

   • パッケージがインストールされていることを確認します（uv pip list）
   • Python 環境が有効化されていることを確認します

2. アクセスが拒否された場合：

   • args 内のディレクトリが存在することを確認します
   • 指定したディレクトリへの読み取り権限があることを確認します

3. Claude Desktop にサーバーが表示されない場合：

   • 設定ファイルの構文を確認します
   • 設定を変更した後、Claude Desktop を再起動します