Local File Operation MCP Server

MCPAI代理

提供方 DawidNowak

AI代理 未标注 会话登录 社区 / 第三方 Claude DesktopClaude

一个基于Model Context Protocol (MCP)的服务器,使Claude Desktop能够安全地与本地文件系统交互,提供文件读写、列表和管理功能。

一句话选型结论

按资料字段整理

Local File Operation MCP Server 属于AI代理类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文件管理C#本地部署安全协议本地交互AI助手开发工具

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Local File Operation MCP Server当前 4 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方DawidNowak上游标注的维护方 DawidNowak
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.0 KB
来自项目仓库与上游目录的原文,未做删改

本地文件MCP服务器

A. 模型上下文协议(MCP) 启用的服务器 Claude Desktop(可译为“克劳德桌面版”或保持原名“Claude Desktop”,具体取决于语境和品牌偏好) 为了安全地与您的本地文件系统进行交互,该服务器采用C# .NET 8.0构建,提供在您主目录内的安全文件操作,使Claude能够直接在您的计算机上读取、写入、列出和管理文件。

🤖 这是什么?

这个MCP服务器填补了(或连接了)……之间的鸿沟 Claude Desktop(克劳德桌面版) (Anthropic的桌面应用程序)以及您的本地文件系统。配置完成后,您可以要求Claude:

  • “列出我文档文件夹中的所有文件”
  • “阅读我项目中的README文件内容”
  • “创建一个名为 hello.py 的新 Python 脚本”
  • “删除我下载文件夹中的临时文件”

服务器使用 模型上下文协议这是一种标准化的方式,让AI助手能够安全地访问外部资源。它通过stdin/stdout使用JSON-RPC 2.0与Claude Desktop进行通信,提供了一个安全的沙盒环境,将所有操作限制在您的主目录内。

🌟 特点

  • 🔒 安全所有操作均限于您的主目录内进行
  • 📁 文件浏览列出文件和目录及其详细元数据
  • 📖 文件读取读取文本文件,具备编码检测和大小限制功能
  • ✏️ 文件写入以原子写入操作创建和编辑文件
  • 🗑️ 文件删除在安全检查后删除文件和目录
  • 🛡️ 安全第一二进制文件检测、大小限制、路径验证

🚀 快速入门

先决条件

  • .NET 8.0 SDK(软件开发工具包) 或之后
  • Windows、macOS 或 Linux

安装

选项1:自动设置(推荐)

  1. 克隆仓库:```bash
    git clone https://github.com/your-username/local-files-mcp-server.git
    cd local-files-mcp-server

1. **运行安装脚本:**```powershell
.\setup.ps1

这将会:

  • 构建并发布MCP服务器
  • 自动配置Claude桌面版
  • 创建必要的配置文件
  1. 重启Claude桌面版 并查找“✅ 本地文件:已连接”

选项2:手动设置

  1. 克隆并构建:```bash
    git clone https://github.com/your-username/local-files-mcp-server.git
    cd local-files-mcp-server
    dotnet build

1. **对于Claude Desktop的集成:**

- 发布可执行文件: `dotnet publish -c Release -o publish --self-contained true -r win-x64 /p:PublishSingleFile=true`
- 复制 `claude_desktop_config.json` to `%APPDATA%\Claude\claude_desktop_config.json`
- 编辑配置文件以替换 `PATH_TO_REPO` 使用您实际的仓库路径
- 重启Claude桌面版

1. **直接使用方法:**```bash
dotnet run --project LocalFilesMcpServer

服务器通过(某种方式)进行通信 标准输入/标准输出 使用JSON-RPC 2.0协议。

截图

在Claude Desktop中查看MCP服务器的运行情况:

  • 创建目录 - 通过Claude桌面创建新目录
  • 列出文件 - 浏览目录内容并查看详细元数据
  • 写入文件 - 创建包含自定义内容的新文件
  • 读取文件 - 阅读并分析文件内容
  • 删除目录 - 删除目录并清理

这些截图展示了通过Claude Desktop集成所实现的完整文件管理流程。

📋 可用工具

1. list_files - 浏览目录内容

列出带有元数据的文件和目录```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_files",
"arguments": {
"path": "Documents"
}
}
}


### 2. `read_file` - 读取文件内容

**读取最大50MB的文本文件**```json
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "read_file",
"arguments": {
"path": "Documents/example.txt"
}
}
}

3. write_file - 创建/编辑文件

以原子操作将内容写入文件```json
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "write_file",
"arguments": {
"path": "Documents/new_file.txt",
"content": "Hello, World!\nThis is a new file."
}
}
}


### 4. `delete_file` - 删除文件/目录

**删除文件或目录(对于目录递归删除)**```json
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "delete_file",
"arguments": {
"path": "Documents/old_file.txt"
}
}
}

🔧 使用示例

完整工作流示例```bash

Initialize MCP session

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"example-client","version":"1.0.0"}}}' | dotnet run --project LocalFilesMcpServer

List available tools

echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | dotnet run --project LocalFilesMcpServer

Browse files in Documents folder

echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_files","arguments":{"path":"Documents"}}}' | dotnet run --project LocalFilesMcpServer


### 交互式测试

创建一个测试脚本(`test_session.txt`):```json
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_files","arguments":{"path":"."}}}
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"write_file","arguments":{"path":"test.txt","content":"Hello MCP!"}}}
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"read_file","arguments":{"path":"test.txt"}}}
{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"delete_file","arguments":{"path":"test.txt"}}}

运行它:```bash
type test_session.txt | dotnet run --project LocalFilesMcpServer


## 🛡️ 安全特性

- **主目录限制**所有路径均相对于您的主目录解析
- **路径验证**防止目录遍历攻击(例如。, `../../../etc/passwd`)
- **文件大小限制**读取限制为50MB,写入限制为50MB
- **二进制文件检测**自动检测并拒绝读取二进制文件
- **权限检查**在操作前验证读/写权限
- **原子写入**文件以原子方式写入(临时文件 + 移动)以防止损坏

## 📁 项目结构```
LocalFilesMcpServer/
├── Models/             # MCP protocol message models
│   ├── McpMessage.cs   # Base JSON-RPC 2.0 classes
│   ├── InitializeMessage.cs
│   ├── ToolMessage.cs
│   ├── CallToolMessage.cs
│   ├── Tool.cs
│   └── FileItem.cs
├── Services/           # Core business logic
│   ├── McpProtocolHandler.cs   # MCP protocol routing
│   ├── FileOperationService.cs # File system operations
│   └── PathValidationService.cs # Security validation
├── Tools/              # Individual tool implementations
│   ├── ListFilesTool.cs
│   ├── ReadFileTool.cs
│   ├── WriteFileTool.cs
│   └── DeleteFileTool.cs
└── Program.cs          # Application entry point

🔍 错误处理

服务器提供详细的错误信息,这些信息紧跟在MCP错误代码之后:

  • -32700解析错误(JSON格式错误)
  • -32600无效请求
  • -32601未找到方法
  • -32602无效参数
  • -32603内部错误
  • -32002服务器未初始化

示例错误响应:```json
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32602,
"message": "Error: File not found. Action: Provide a valid file path for file access"
}
}


## 🧪 开发

### 构建与测试```bash
# Build the project
dotnet build

# Run all tests (when implemented)
dotnet test

# Check code formatting
dotnet format --verify-no-changes

📖 MCP 协议

这个服务器实现了 模型上下文协议 规格:

  • 协议版本: 2024-11-05 并且 2025-06-18 (多版本支持以确保兼容性)
  • 交通stdio(stdin/stdout)
  • 消息格式JSON-RPC 2.0
  • 能力工具(文件操作)

📝 许可证

这个项目采用MIT许可证授权——详见 许可证 文件中详述。


用Claude快乐地管理文件! 🚀

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Local File Operation MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Local File Operation MCP Server 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Local File Operation MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Local File Operation MCP Server 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Local File Operation MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Local File Operation MCP Server 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 安全协议、C#、Claude、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。