MCP Local File Server

🚀 MCPローカルファイルサーバ

MCP（管理コントロールパネル）を使用してローカルファイルにアクセスおよび操作するためのサーバです。

🚀 クイックスタート

このサーバを使用するには、以下の手順に従ってインストールと起動を行います。

📦 インストール

1. リポジトリをクローンします。

git clone https://github.com/fmorus/mcp-local-file-server.git
cd mcp-local-file-server

2. 依存関係をインストールします。

npm install

3. サーバを起動します。

npm start

サーバは http://localhost:3000 で実行されます。

📚 ドキュメント

📄 API インターフェース

ファイルの一覧表示

• GET /files?dir={directory}
• 指定されたディレクトリ内のすべてのファイルを一覧表示します。
• パラメータ dir はオプションです（デフォルト：カレントディレクトリ）

ファイルの読み取り

• GET /file?path={file_path}
• ファイルの内容を読み取ります。

ファイルのアップロード

• POST /file
• ファイルをアップロードします。
• multipart/form-data 形式を使用し、フィールド名は file です。

ファイルの更新

• PUT /file
• ファイルの内容を更新します。
• リクエストボディ：{ "path": "file_path", "content": "new_content" }

ファイルの削除

• DELETE /file?path={file_path}
• ファイルまたはディレクトリを削除します。

💻 使用例

基本的な使用法

// ファイルの一覧表示
fetch('http://localhost:3000/files')
  .then(response => response.json())
  .then(files => console.log(files));

// ファイルの読み取り
fetch('http://localhost:3000/file?path=/caminho/do/arquivo.txt')
  .then(response => response.json())
  .then(data => console.log(data.content));

// ファイルのアップロード
const formData = new FormData();
formData.append('file', arquivoParaUpload);
fetch('http://localhost:3000/file', {
  method: 'POST',
  body: formData
});

// ファイルの更新
fetch('http://localhost:3000/file', {
  method: 'PUT',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    path: '/caminho/do/arquivo.txt',
    content: 'Novo conteúdo'
  })
});

// ファイルの削除
fetch('http://localhost:3000/file?path=/caminho/do/arquivo.txt', {
  method: 'DELETE'
});

⚠️ 重要提示

このサーバはシステムファイルに完全なアクセス権を持っています。安全で信頼できる環境でのみ使用してください。