MCP File Tools

🚀 MCP File Tools

MCPサーバーは、非UTF-8エンコーディングをサポートしたファイル操作を行います。22種類のエンコーディング（キリル文字、Windows - 125x、ISO - 8859、KOI8、UTF - 16）を自動検出して変換するため、AIアシスタントがデータを破損することなくレガシーファイルの読み書きができます。

🚀 クイックスタート

ClaudeはНастройкиを正しく認識します。MCP File Toolsを使えば、非UTF - 8エンコーディングのファイルをAIアシスタントが問題なく扱えるようになります。インストール後、Claudeに特定のコマンドを投げるだけで、ファイル操作が可能です。

✨ 主な機能

• 19種類のファイル操作ツールを提供し、自動エンコーディング変換機能付き。
• 22種類のエンコーディングをサポート。
• セキュリティ面では、許可されたディレクトリのみにアクセス可能。

📦 インストール

MCP Registry

このサーバーは公式MCP Registryに登録されており、簡単に発見できます。

Windows x64

注意：これらのコマンドはPowerShellで実行してください。

# ダウンロード
mkdir -Force "$env:LOCALAPPDATA\Programs\mcp-file-tools"
iwr "https://github.com/dimitar-grigorov/mcp-file-tools/releases/latest/download/mcp-file-tools_windows_amd64.exe" -OutFile "$env:LOCALAPPDATA\Programs\mcp-file-tools\mcp-file-tools.exe"
# Claude Code + VSCodeでインストール（D:\Projectsへのアクセスを許可）
claude mcp add --scope user file-tools -- "$env:LOCALAPPDATA\Programs\mcp-file-tools\mcp-file-tools.exe" "D:\Projects"

Linux x64

# ダウンロード
mkdir -p ~/.local/bin
curl -L "https://github.com/dimitar-grigorov/mcp-file-tools/releases/latest/download/mcp-file-tools_linux_amd64" -o ~/.local/bin/mcp-file-tools
chmod +x ~/.local/bin/mcp-file-tools
# Claude Code + VSCodeでインストール（~/Projectsへのアクセスを許可）
claude mcp add --scope user file-tools -- ~/.local/bin/mcp-file-tools ~/Projects

macOS ARM64

# ダウンロード
mkdir -p ~/.local/bin
curl -L "https://github.com/dimitar-grigorov/mcp-file-tools/releases/latest/download/mcp-file-tools_darwin_arm64" -o ~/.local/bin/mcp-file-tools
chmod +x ~/.local/bin/mcp-file-tools
# Claude Code + VSCodeでインストール（~/Projectsへのアクセスを許可）
claude mcp add --scope user file-tools -- ~/.local/bin/mcp-file-tools ~/Projects

Go Install (全プラットフォーム)

# Goでインストール（Go 1.23+が必要）
go install github.com/dimitar-grigorov/mcp-file-tools/cmd/mcp-file-tools@latest
# Claude Code + VSCodeに追加（Linux/macOS）
claude mcp add --scope user file-tools -- $(go env GOPATH)/bin/mcp-file-tools ~/Projects

# Claude Code + VSCodeに追加（Windows PowerShell）
claude mcp add --scope user file-tools -- "$(go env GOPATH)\bin\mcp-file-tools.exe" "D:\Projects"

その他のクライアント

Claude Desktop、VSCode、またはCursorでは、ダウンロードしたバイナリのパスを設定に使用します。

Claude Desktop（Windowsでは%APPDATA%\Claude\claude_desktop_config.json、macOSでは~/Library/Application Support/Claude/claude_desktop_config.json）： Windows:

{
  "mcpServers": {
    "file-tools": {
      "command": "C:\\Users\\YOUR_NAME\\AppData\\Local\\Programs\\mcp-file-tools\\mcp-file-tools.exe",
      "args": ["D:\\Projects", "C:\\Users\\YOUR_NAME\\Documents"]
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "file-tools": {
      "command": "/Users/YOUR_NAME/.local/bin/mcp-file-tools",
      "args": ["/Users/YOUR_NAME/Projects", "/Users/YOUR_NAME/Documents"]
    }
  }
}

args配列は、サーバーがアクセスできる許可されたディレクトリを指定します。必要なだけディレクトリを追加できます。

VSCode / Cursor (Claude Code拡張機能) 上記のインストール手順でclaude mcp add --scope userを実行した場合、VSCodeでサーバーが使用可能になっています。追加の設定は必要ありません。 VSCodeだけで個別に設定するには：

claude mcp add --scope user file-tools -- "%LOCALAPPDATA%\Programs\mcp-file-tools\mcp-file-tools.exe" "D:\Projects"

または、プロジェクトルートに.mcp.jsonを追加してプロジェクトごとの設定を作成できます：

{
  "mcpServers": {
    "file-tools": {
      "type": "stdio",
      "command": "C:\\Users\\YOUR_NAME\\AppData\\Local\\Programs\\mcp-file-tools\\mcp-file-tools.exe",
      "args": ["D:\\Projects", "D:\\Other\\Directory"]
    }
  }
}

注意：type: "stdio"フィールドは必須です。args配列は許可されたディレクトリを指定します。VSCode拡張機能は自動的にワークスペースディレクトリを追加しないため、アクセスしたいすべてのディレクトリをリストする必要があります。後でディレクトリを追加するには、すべてのディレクトリをリストしてclaude mcp addコマンドを再実行します（前の設定を上書きします）。

全ツールの自動承認 (Claude Code)

すべてのfile - toolsコマンドの許可プロンプトをスキップするには、プロジェクトルートに.claude/settings.local.jsonを作成します：

{
  "permissions": {
    "allow": [
      "Bash(ls *)",
      "Bash(grep *)",
      "Bash(sort *)",
      "Bash(wc *)",
      "Bash(find *)",
      "Bash(echo *)",
      "Grep",
      "Glob",
      "WebSearch",
      "mcp__file-tools__read_text_file",
      "mcp__file-tools__read_multiple_files",
      "mcp__file-tools__write_file",
      "mcp__file-tools__edit_file",
      "mcp__file-tools__copy_file",
      "mcp__file-tools__list_directory",
      "mcp__file-tools__tree",
      "mcp__file-tools__directory_tree",
      "mcp__file-tools__search_files",
      "mcp__file-tools__grep_text_files",
      "mcp__file-tools__detect_encoding",
      "mcp__file-tools__convert_encoding",
      "mcp__file-tools__detect_line_endings",
      "mcp__file-tools__list_encodings",
      "mcp__file-tools__get_file_info",
      "mcp__file-tools__create_directory",
      "mcp__file-tools__list_allowed_directories"
    ]
  }
}

これにより、安全な読み取り専用および編集用のfile - tools操作、一般的なシェルコマンド、およびウェブ検索が自動承認されます。破壊的な操作（delete_file、move_file）とWebFetchは意図的に除外されており、Claudeは使用する前に確認します。必要に応じて調整してください。

検証とアンインストール

# サーバーが設定されているか確認
claude mcp list

# サーバーを削除
claude mcp remove file-tools

💻 使用例

基本的な使用法

インストール後、Claudeに以下のようなコマンドを投げるだけです。

- "このディレクトリ内のすべての.pasファイルをリストアップ"
- "config.iniを読み取り、そのエンコーディングを検出"
- "すべてのサポートされているエンコーディングを表示"
- "MainForm.dfmをCP1251エンコーディングで読み取り"

高度な使用法

セキュリティ面では、サーバーは明示的に許可されたディレクトリのみにアクセスできます。

• 自動：Claude Desktop/Codeは自動的にワークスペースディレクトリを提供します。
• 手動：設定のargs: ["/path/to/project"]でディレクトリを指定します。

📚 ドキュメント

設定

サーバーは環境変数を介して設定できます。

上書きするには、設定で環境変数を設定します（Claude Desktopの例）：

{
  "mcpServers": {
    "file-tools": {
      "command": "C:\\Users\\YOUR_NAME\\AppData\\Local\\Programs\\mcp-file-tools\\mcp-file-tools.exe",
      "args": ["D:\\Projects"],
      "env": {
        "MCP_DEFAULT_ENCODING": "utf-8"
      }
    }
  }
}

ユースケース

レガシーコードベース

多くのレガシープロジェクトでは、AIアシスタントがネイティブで扱えない非UTF - 8エンコーディングが使用されています。

• Delphi/Pascal (Windows - 1251)：キリル文字のUIテキストを含むソースファイル。
• Visual Basic 6 (Windows - 1252)：西ヨーロッパ文字を含むフォームと設定ファイル。
• レガシーPHP/HTML (CP1251, ISO - 8859 - 1)：ローカライズされたコンテンツを含むウェブアプリ。
• 古い設定ファイル (様々)：INI、プロパティ、レジストリファイルなどのレガシーエンコーディング。

動作原理：

ユーザー: config.iniを読み取り、タイトルを"Настройки"に変更
アシスタント: [read_text_file with cp1251] → [modify UTF - 8] → [write_file with cp1251]

元のエンコーディングが保持されるため、ファイルはレガシーツールと互換性を維持します。

開発

前提条件：Go 1.23+

# テストを実行
go test ./...

# ビルド
go build -o mcp-file-tools ./cmd/mcp-file-tools

MCP Inspectorを使用したデバッグ

MCP Inspectorは、MCPサーバーをテストするためのウェブUIを提供します。

前提条件：Node.js v18+

# 許可されたディレクトリで実行（必須）
npx @modelcontextprotocol/inspector go run ./cmd/mcp-file-tools -- /path/to/allowed/dir

# またはビルド済みのバイナリで
npx @modelcontextprotocol/inspector ./mcp-file-tools.exe C:\Projects

ブラウザが開き、ツールを表示し、カスタム引数で呼び出し、応答を検査できます。

手動デバッグ

許可されたディレクトリでサーバーを実行し、stdinを介してJSON - RPCコマンドを送信します：

# 許可されたディレクトリを指定
go run ./cmd/mcp-file-tools /path/to/project

例のコマンド（ターミナルに貼り付け）：

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_directory","arguments":{"path":"/path/to/project","pattern":"*.go"}}}
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"read_text_file","arguments":{"path":"/path/to/project/main.pas","encoding":"cp1251"}}}
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"detect_encoding","arguments":{"path":"/path/to/project/file.txt"}}}

📄 ライセンス

GPL - 3.0 - LICENSEを参照してください。