Fastmcp File Server

MCPAI代理

提供方 Luxshan2000

AI代理 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaude
查看接入方式

FastMCP File Server 是一个多功能、安全的文件服务器,实现了模型上下文协议(MCP),为AI助手提供安全的文件操作功能。支持多种连接模式、可配置的访问级别和全面的安全控制,适用于各种部署场景。

一句话选型结论

按资料字段整理

Fastmcp File Server 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

文件管理Python本地部署安全文件操作AI助手集成多连接模式访问控制

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install fastmcp-file-server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

多步任务编排

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

自动化重复流程

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

选择建议

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

值得选的地方

  • 资料标注 35 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Fastmcp File Server当前 35 stdio · 本地进程 本地部署 有 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代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Luxshan2000上游标注的维护方 Luxshan2000
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

FastMCP文件服务器

一个多功能、安全的文件服务器,实现了模型上下文协议(MCP),为AI助手提供安全的文件操作。具有多种连接模式、可配置的访问级别和针对各种部署场景的全面安全控制。

🚀 特性

  • 全面的文件操作:创建、读取、写入、删除、复制、移动、重命名文件和目录
  • 高级文本操作:特定行操作、搜索和替换、模式匹配
  • 文件分析:大小、权限、时间戳、哈希验证、差异生成
  • 批量操作:在单个操作中高效处理多个文件
  • 存档支持:创建和提取ZIP文件
  • 格式转换:文本到PDF、图像格式转换、CSV↔ 对象符号
  • 多种连接模式:stdio、HTTP和通过ngrok的公共访问
  • 分层访问控制:只读、读/写和管理员权限级别
  • 安全第一:所有操作仅限于配置的安全目录

📦 安装

来自PyPI(推荐)```bash

Using uv (recommended)

uv tool install fastmcp-file-server

Using pip

pip install fastmcp-file-server


### 来源```bash
git clone https://github.com/Luxshan2000/Local-File-MCP-Server.git
cd Local-File-MCP-Server
uv sync

🔧 快速开始

基本用法```bash

Set allowed directory

export MCP_ALLOWED_PATH="/path/to/your/files"

Start stdio server (for Claude Desktop)

fastmcp-file-server

Start HTTP server

fastmcp-file-server-http

Start HTTP server bypassing security warning (not recommended)

fastmcp-file-server-http --ignore-keys


### 通过身份验证```bash
# Set admin key for HTTP mode
export MCP_ADMIN_KEY="your-secret-token"
export MCP_HTTP_PORT=8082
fastmcp-file-server-http

⚙️ 配置

环境变量

变量 默认值 描述
MCP_ALLOWED_PATH ./allowed 文件操作的目录路径
MCP_HTTP_PORT 8082 HTTP服务器端口
MCP_READ_KEY None 只读访问令牌
MCP_WRITE_KEY None 读/写访问令牌
MCP_ADMIN_KEY None 管理员访问令牌(包括删除)
MCP_MAX_FILE_SIZE 10485760 最大文件大小(以字节为单位)(10MB)
MCP_ALLOWED_EXTENSIONS .txt,.json,.md,... 允许的文件扩展名(逗号分隔)

配置文件

创建一个 .env 项目根目录中的文件:```bash

Required: Safe directory for file operations

MCP_ALLOWED_PATH=/absolute/path/to/your/files

Optional: HTTP server settings

MCP_HTTP_PORT=8082

Optional: Multi-tier authentication tokens

MCP_READ_KEY=readonly-token-here
MCP_WRITE_KEY=readwrite-token-here
MCP_ADMIN_KEY=admin-token-here

Optional: File restrictions

MCP_MAX_FILE_SIZE=10485760
MCP_ALLOWED_EXTENSIONS=.txt,.json,.md,.csv,.log,.xml,.yaml,.yml,.conf,.cfg,.zip,.pdf,.jpg,.png


## 🔗 整合

### Claude桌面集成

**配置文件位置:**

- **macOS**: `~/Library/Application Support/Claude/config.json`
- **视窗**: `%APPDATA%\Claude\config.json`

#### 标准模式(直接集成)```json
{
"mcpServers": {
"local-file-server": {
"command": "fastmcp-file-server",
"env": {
"MCP_ALLOWED_PATH": "/absolute/path/to/your/allowed/directory"
}
}
}
}

HTTP模式(本地服务器)

  1. 启动HTTP服务器:```bash
    export MCP_ADMIN_KEY="your-secret-token"
    fastmcp-file-server-http

2. 配置Claude桌面:```json
{
"mcpServers": {
"local-file-server-http": {
"transport": "http",
"url": "http://127.0.0.1:8082/mcp",
"headers": {
"Authorization": "Bearer your-secret-token"
}
}
}
}

带有mcp远程代理的HTTP模式

对于需要代理的环境:```bash

Install mcp-remote

npm install -g mcp-remote
``````json
{
"mcpServers": {
"local-file-server-proxy": {
"command": "npx",
"args": [
"mcp-remote",
"http://127.0.0.1:8082/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer your-secret-token"
}
}
}
}


### 公众访问与ngrok

对于基于网络的人工智能系统(ChatGPT等):```bash
# Terminal 1: Start authenticated HTTP server
export MCP_ADMIN_KEY="your-secret-token"
export MCP_HTTP_PORT=8082
fastmcp-file-server-http

# Terminal 2: Expose publicly via ngrok
ngrok http 8082

在基于web的AI系统中使用ngrok URL:

  • 统一资源定位符: https://abc123.ngrok.io/mcp
  • 头球: Authorization: Bearer your-secret-token

🔒 安全

安全功能

⚠️ HTTP模式安全警告:

在未配置任何身份验证令牌的情况下启动HTTP服务器时,系统将显示安全警告并提示确认。这可以防止意外运行未受保护的服务器。```bash

This will trigger a security warning:

fastmcp-file-server-http

To bypass the warning (not recommended):

fastmcp-file-server-http --ignore-keys


### 许可证管理

**⚠️ 重要安全注意事项:**

- **带钥匙**:设置任何令牌时(`MCP_READ_KEY`, `MCP_WRITE_KEY`,或 `MCP_ADMIN_KEY`),所有HTTP请求都需要 `Authorization: Bearer ` 头球
- **没有钥匙**:如果没有设置令牌,服务器将在没有身份验证的情况下运行(仅在安全环境中使用)
- **多层访问**:不同的令牌提供不同的权限级别
- **临时暴露**:对于ngrok或临时远程访问,始终使用强令牌,并在完成后撤销访问
- **关键点旋转**:定期轮换代币,尤其是在临时曝光之后

### 访问级别

- **未设置令牌**:服务器在没有身份验证的情况下运行(stdio模式安全,仅HTTP本地)
- **读取令牌**: `MCP_READ_KEY` -文件列表、读取、搜索、比较操作
- **写入令牌**: `MCP_WRITE_KEY` -所有读取操作以及创建、修改、复制、移动、转换
- **管理员令牌**: `MCP_ADMIN_KEY` -所有操作,包括文件和目录删除

### 最佳实践

1. **永远不要泄露秘密**:使用 `.env` 文件(添加到 `.gitignore`)
1. **使用强令牌**:生成加密安全的随机令牌(`openssl rand -hex 32`)
1. **限制访问范围**:设置 `MCP_ALLOWED_PATH` 到所需的最小目录
1. **选择适当的令牌级别**:使用只读令牌进行分析,仅在需要删除时使用管理员
1. **监控使用情况**:检查日志中是否有未经授权的访问尝试
1. **临时通道**:取消设置所有令牌,并在临时暴露后重新启动

## 💡 使用示例

### 文件操作```
# Basic operations
"Create a file called notes.txt with my meeting notes"
"Read lines 10-20 from config.py"
"Copy config.json to backup/config_backup.json"

# Advanced operations
"Search for 'TODO' comments in all Python files"
"Replace 'old_function' with 'new_function' in utils.py"
"Create a ZIP archive of all source files"
"Convert report.txt to PDF format"
"Calculate SHA256 hash of important_file.pdf"

批量操作```

"Read all .py files in the src/ directory"
"Create these 5 configuration files with their content"
"Delete all .tmp files in the workspace"
"Find all JavaScript files containing 'console.log'"


## 🛠️ 发展

看 开发商.md 详细的开发设置和贡献指南。

### 快速开发设置```bash
# Clone repository
git clone https://github.com/Luxshan2000/Local-File-MCP-Server.git
cd Local-File-MCP-Server

# Install dependencies
uv sync

# Run development server
uv run server          # stdio mode
uv run server-http     # HTTP mode

# Run tests and linting
uv run test
uv run lint
uv run format

📊 api参考

可用工具

工具 描述 访问级别
read_file 读取文件内容或特定行范围 只读
write_file 创建或覆盖文件 读/写
append_file 将内容附加到现有文件 读/写
delete_file 删除文件和目录 管理员
copy_file 复制文件和目录 读/写
move_file 移动/重命名文件和目录 读/写
list_directory 使用筛选列出目录内容 只读
create_directory 创建新目录 读/写
get_file_info 获取文件元数据和权限 只读
search_files 按名称模式搜索文件 只读
search_content 使用正则表达式搜索文件内容 只读
replace_content 查找和替换文件中的文本 读/写
insert_lines 在特定行号处插入文本 读/写
delete_lines 删除特定行范围 读/写
compare_files 在文件之间生成差异 只读
create_archive 创建ZIP存档 读/写
extract_archive 提取ZIP存档 读/写
calculate_hash 生成文件哈希值(MD5、SHA1、SHA256) 只读
convert_document 将文本转换为PDF 读/写
convert_image 在图像格式之间转换 读/写
convert_data CSV和JSON之间的转换 读/写

🐛 故障排除

常见问题

服务器无法启动:```bash

Reinstall dependencies

uv sync

Check Python version

python --version # Requires Python 3.10+
```

Claude Desktop未连接:

  1. 验证配置中的所有路径都是绝对路径(完整路径)
  2. 更改配置后重新启动Claude Desktop
  3. 检查服务器是否正常启动: uv run server
  4. 确保 MCP_ALLOWED_PATH 目录存在并且可以访问

HTTP身份验证失败:

  1. 验证 MCP_ADMIN_KEY 在启动服务器之前设置
  2. 检查授权标头格式: Bearer your-secret-token
  3. 确保令牌完全匹配(没有额外空格)

权限被拒绝错误:

  1. 检查文件/目录权限
  2. 验证 MCP_ALLOWED_PATH 可访问
  3. 确保用户在允许的目录中具有读/写权限

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🤝 贡献

我们欢迎捐款!请看 开发商.md 用于开发设置和 代码_OF_CONDUCT.md 社区指南。

🔗 链接

  • 仓库: https://github.com/Luxshan2000/Local-File-MCP-Server
  • PyPI包: https://pypi.org/project/fastmcp-file-server/
  • 问题: https://github.com/Luxshan2000/Local-File-MCP-Server/issues
  • 模型上下文协议: https://modelcontextprotocol.io/

⭐ 支持

如果你觉得这个项目有用,请考虑在GitHub上给它一颗星!

常见问题

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

在客户端按下面的安装命令接入:pip install fastmcp-file-server。装完在客户端配置里引用同一个包或端点。

Fastmcp File Server 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Fastmcp File Server 收费吗?

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

Fastmcp File Server 需要 API Key 吗?

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

Fastmcp File Server 支持哪些客户端?

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

Fastmcp File Server 能提供哪些能力?

资料显示约 35 个工具;能力标签包括 安全、Python、Claude、访问控制。具体工具清单以官方文档为准。

Fastmcp File Server 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Fastmcp File Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

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

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