Simple MCP FileServer
2025.04.21
1
JavaScript文件系统服务AI代理交互文件管理
Simple MCP FileServer 是一个轻量级的模型上下文协议（MCP）文件系统服务器，允许AI代理（如Codeium、Claude、Windsurf等）通过标准化的JSON-RPC接口与本地文件系统进行交互。该服务器作为AI代理与文件系统之间的桥梁，支持读取、写入和操作文件等基本功能，适用于需要AI助手协助处理文件操作的场景。
View on GitHub
Overview
基本能力
产品定位
Simple MCP FileServer 是一个轻量级的文件系统服务器，专为AI代理设计，使其能够通过标准化的JSON-RPC接口与本地文件系统进行交互。
核心功能
- 文件操作：
- 读取文件内容（
readFile方法） - 写入或覆盖文件内容（
writeFile方法） - 列出目录内容（
listDir方法） - MCP协议兼容性：
- 完全符合JSON-RPC 2.0协议
- 支持
initialize方法进行能力报告 - 详细的错误处理和日志记录
- CORS支持：内置跨域支持，便于Web客户端集成
- 健康检查：提供
/health端点用于监控和探测
适用场景
- AI助手协助处理文件操作
- 开发环境中自动化文件管理
- 需要AI代理访问本地文件系统的应用
工具列表
readFile：读取文件内容writeFile：写入或覆盖文件内容listDir：列出目录内容
常见问题解答
- 初始化失败：确保服务器正在运行，检查端口是否被占用，验证
/health端点是否返回ok。 - 端口冲突：使用
lsof -i :<port>检查端口使用情况，或使用不同的端口启动服务。 - 权限问题：确保服务器有权限访问请求的文件路径。
使用教程
使用依赖
- 确保已安装Node.js和npm。
安装教程
- 克隆仓库：
bash git clone https://github.com/yourusername/simple-mcp-fileserver.git cd simple-mcp-fileserver - 安装依赖：
bash npm install
调试方式
- 启动服务器：
bash node simple-mcp-fileserver.js或使用自定义端口：bash PORT=9000 node simple-mcp-fileserver.js - 检查健康状态：
bash curl http://localhost:8090/health应返回ok。