Philgei MCP Server Filesystem

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

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

🚀 クイックスタート

インストール

UVX を使用してインストールするには、以下のコマンドを実行します。

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

✨ 主な機能

この MCP ファイルシステムサーバは、Claude Desktop と連携して使用することができます。具体的な連携方法は以下の通りです。

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 を再起動します。

⚠️ 重要提示

このプロジェクトは非公式のものであり、Anthropic とは関係がありません。本番環境での使用は避けてください。

💡 使用建议

設定ファイルを編集する際は、ディレクトリのパスを正確に指定し、構文エラーがないように注意してください。