local-file-reader
ローカルファイルを安全に読み取り、検索できるMCPサーバーです。
機能
- list_files: ベースディレクトリ配下のファイル/フォルダ一覧を取得
- read_file: テキストファイルの内容を読み取る
- search_text: キーワードでテキストを検索
セットアップ
1. 依存関係をインストール
pip install -r requirements.txt
2. ベースディレクトリを準備
デフォルトでは D:\MCP_Server をベースディレクトリとして使用します。必要に応じて、このディレクトリを作成し、読み取りたいファイルを配置してください。
mkdir D:\MCP_Server
3. サーバーを起動
python file_reader_mcp.py
使用例
Claude に以下のようにリクエストできます：
list_files で D:\MCP_Server のファイル一覧を表示してください
read_file で sample.txt の内容を読み取ってください
search_text で "error" キーワードを検索してください
設定
file_reader_mcp.py の以下の場所でベースディレクトリを変更できます：
BASE_DIR = Path(r"D:\MCP_Server").resolve()
許可されるファイル拡張子
.txt.md.log.json.yaml,.yml.ini.csv
新しい拡張子を追加する場合は、ALLOWED_EXTENSIONS を編集してください：
ALLOWED_EXTENSIONS = {
".txt", ".md", ".log", ".json", ".yaml", ".yml", ".ini", ".csv", ".yourext"
}
セキュリティ機能
- BASE_DIR外へのアクセス禁止
- ファイルサイズ上限：1MB（MAX_FILE_SIZE で変更可能）
- 許可された拡張子のみ読み取り可能
- 検索結果は最大100件まで
ツール仕様
list_files
list_files(relative_dir: str = "", pattern: str = "*") -> list[str]
パラメータ:
relative_dir: ベースディレクトリからの相対パス（デフォルト: ルート）pattern: ファイル名パターン（fnmatchで評価）
例:
list_files("docs", "*.md") # docs フォルダの .md ファイル一覧
read_file
read_file(relative_path: str) -> str
パラメータ:
relative_path: ベースディレクトリからの相対パス
例:
read_file("config.json") # ルートの config.json を読み取る
read_file("docs/readme.md") # docs/readme.md を読み取る
search_text
search_text(keyword: str, relative_dir: str = "") -> list[dict]
パラメータ:
keyword: 検索キーワードrelative_dir: 検索対象ディレクトリ（デフォルト: ルート全体）
戻り値:
[
{
"path": "folder/file.txt",
"line": 42,
"text": "マッチした行の内容（最初の300文字）"
}
]
例:
search_text("error", "logs") # logs フォルダで "error" を検索
トラブルシューティング
BaseDir が見つからない
BASE_DIR に指定したディレクトリが存在することを確認してください。
ファイルが読み取り不可
- ファイルの拡張子が ALLOWED_EXTENSIONS に含まれているか確認してください
- ファイルサイズが 1MB を超えていないか確認してください
- ファイルが UTF-8 でエンコードされていることを確認してください（そうでない場合は自動的に置換エラーで処理されます）
ACCESS_DENIED エラー
relative_path が BASE_DIR 外のファイルを指していないか確認してください。
Claude Code で local-file-reader が認識されない
.mcp.jsonがプロジェクトルートまたは~/.claude/に配置されているか確認.mcp.jsonの JSON 構文が正しいか確認（オンラインJSONバリデータで検証）argsのパスが正しく設定されているか確認："args": ["d:/VSCode/mcpserver-sample/file_reader_mcp.py"]Claude Code（VSCode拡張）を再起動、またはウィンドウをリロード（Ctrl+Shift+P → "Reload Window"）
CLI の場合は
claude mcp listで登録状況を確認
local-file-reader に接続テスト
サーバーが正しく起動しているか確認：
# テストスクリプトを実行
python test_server.py
よくある問題
Claude Code で local-file-reader が認識されない
.mcp.jsonのargsのパスが正しいか確認してくださいcommandに指定したpythonが PATH に通っているか確認してください
Claude から接続できない
.mcp.jsonの JSON 構文が正しいか確認してください- Claude Code（VSCode拡張）を再起動、またはウィンドウをリロードしてください
