MCP Local File Server

🚀 MCP本地文件服務器

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'
});

📚 詳細文檔

安全注意事項

⚠️ 重要提示

此服務器對系統文件有完全訪問權限。請僅在安全可靠的環境中使用。