Local File Reader

🚀 MCP ローカルファイルリーダー

Model Context Protocol (MCP) をベースにしたローカルファイル読み取りサーバーで、AI モデルが安全にローカルファイルシステムにアクセスできるようにします。

🚀 クイックスタート

MCP ローカルファイルリーダーは、AI モデルにローカルファイルシステムへの安全なアクセスを提供するサーバーです。以下の手順で簡単にセットアップできます。

✨ 主な機能

リソース（Resources）

• ローカルファイルシステム内のファイルを一覧表示し、アクセスすることができます。
• テキストファイルやバイナリファイルなど、複数のファイルタイプをサポートしています。
• ファイルの MIME タイプを自動検出し、適切な内容処理を行います。

ツール（Tools）

• read_file - 指定されたファイルの内容を読み取ります。
  • テキストファイルの場合は完全な内容を返します。
  • バイナリファイルの場合はファイル情報の摘要を返します。
• list_files - 指定されたディレクトリ内のすべてのファイルを一覧表示します。
  • ファイル名のリストを返します。
• get_file_info - 指定されたファイルの詳細情報を取得します。
  • ファイルのサイズ、タイプ、作成時間などのメタデータを返します。

📦 インストール

以下のコマンドを使用してインストールします。

npm install mcp-local-file-reader

💻 使用例

コマンドラインツールとしての使用

インストール後、コマンドラインで直接実行できます。

npx mcp-local-file-reader

これにより、LLM 対話を監視する MCP ノードサーバーが起動します。

AI ツールとの統合

Windsurf での使用

Windsurf では、mcp-local-file-reader を手動で起動する必要はありません。設定するだけで、Windsurf が自動的に起動します（Windsurf の mcp_config.json で設定し、refresh をクリックしてサーバーを更新します）。

1. Windsurf の mcp_config.json 設定ファイルに以下の設定を追加します（一時的に FILE_TOOLS_API_KEY は不要です）。

ローカルデプロイ

{
  "servers": {
    "file-tools": {
      "command": "cmd",
      "args": [
        "/c",
        "node",
        "path/to/mcp-local-file-reader/build/index.js"
      ],
      "env": {
        "FILE_TOOLS_API_KEY": ""
      }
    }
  }
}

npm を使用したデプロイ

{
  "servers": {
    "file-tools": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "mcp-local-file-reader"
      ],
      "env": {
        "FILE_TOOLS_API_KEY": ""
      }
    }
  }
}

Windsurf のダイアログボックスのハンマーアイコンをクリックし、次に refresh をクリックしてサーバーを更新します。 公式設定説明：https://docs.codeium.com/windsurf/mcp

2. 新しい MCP 設定を読み込むために Windsurf を再起動します。

他の MCP 互換の AI アプリでの使用

特定のアプリの MCP 統合ガイドに従って、このサーバーをツールプロバイダーとして追加します。Cursor の設定は Windsurf の設定に似ており、VSCode では少し複雑になる場合があります。しかし、本質的には mcp.json を設定することで、同様の設定を参考にできます。

🔧 開発

依存関係のインストール

npm install

サーバーのビルド

npm run build

開発モード（自動再構築）

npm run watch

MCP Inspector を使用したテスト

npm run inspector

📚 ドキュメント

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

このサーバーは AI モデルにローカルファイルシステムへのアクセスを許可するため、慎重に使用し、以下のことを確認してください。

1. 必要なディレクトリへのアクセスのみを許可します。
2. 機密ファイルやディレクトリを公開しないでください。
3. 本番環境で使用する前に、追加のセキュリティ制限を追加することを検討してください。

📄 ライセンス

MIT