MCP Server Filesystem

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

このプロジェクトは、ClaudeファイルシステムMCPサーバの非公式実装ポートであり、概念実証（POC）としてのみ使用されます。このプロジェクトはAnthropicとは関係がなく、本番環境での使用は推奨されません。MCPサーバの機能をデモンストレーションおよび探索するために作成されています。

🚀 クイックスタート

インストール

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

uv venv
.venv\Scripts\activate  # Windowsシステム上で実行
uv pip install -e .

💻 使用例

Claude Desktopでの使用

1. claude_desktop_config.json ファイルを編集します。

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"  // 任意のディレクトリに置き換えてください
      ]
    }
  }
}

複数のディレクトリを追加することもできます。

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

2. Claude Desktopを再起動して変更を適用します。
3. Claude Desktopで以下の操作を行います。
   • クリップボードアイコンをクリックします。
   • MCPメニュー（2つの接続された電源プラグ）を選択します。
   • ファイルシステムサーバが統合オプションに表示されます。

⚠️ セキュリティに関する注意事項

args 配列で指定されたディレクトリのみがアクセス可能です。サーバは、許可されたディレクトリ外へのアクセスを防止するために、厳格なパス検証を実施しています。

🔧 トラブルシューティング

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

• パッケージがインストールされていることを確認します（uv pip list で確認）。
• Python環境がアクティブになっていることを確認します。

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

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

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

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