简单MCP文件服务器

项目简介

Simple MCP FileServer是一个基于MCP协议的轻量级文件服务实现。它允许通过网络对文件和目录进行基本操作，包括读取、写入、列出目录内容等。

MCP协议介绍

MCP（Multi-Channel Protocol）是一种用于网络数据传输的协议，支持多种通道和数据格式。MCP协议的特点包括：

1. 支持多通道通信
2. 高效的数据序列化
3. 易于扩展的插件系统

工作原理

核心组件

1. 文件服务

   • 提供基本的文件操作，如读取、写入和删除
   • 支持目录遍历

2. 网络通信

   • 使用TCP/IP协议进行数据传输
   • 支持多线程处理请求

3. 安全性

   • 基于权限控制访问
   • 提供SSL/TLS加密选项

功能特点

核心功能

• 文件读取：从指定路径读取文件内容
• 文件写入：将内容写入指定路径
• 目录遍历：列出指定目录中的所有文件和子目录
• 健康检查：提供简单的健康检查端点

可扩展性

• 支持自定义插件系统
• 可扩展的协议支持

安装配置

安装步骤

1. 下载源代码：

   git clone https://github.com/yourusername/simple-mcp-fileserver.git
   

2. 安装依赖：

   npm install
   

3. 启动服务：

   node index.js
   

配置选项

• 监听地址：指定服务器绑定的IP地址，默认为0.0.0.0
• 监听端口：指定服务器监听的TCP端口，默认为8090
• 允许目录：配置可访问的目录列表
• 认证方式：支持多种认证机制，如基于令牌或用户名/密码

使用说明

基本用法

1. 启动服务：

   node index.js --port 8090 --address 0.0.0.0
   

2. 发送请求：
   • 文件读取：

     curl http://localhost:8090/file/read/path/to/file.txt
     

   • 文件写入：

     curl -X POST -d "content=your content" http://localhost:8090/file/write/path/to/file.txt
     

   • 目录遍历：

     curl http://localhost:8090/dir/list/path/to/directory
     

API参考

核心接口

1. GET /file/read/{path}

   • 读取指定路径的文件内容
   • 返回结果：文件内容作为字符串

2. POST /file/write/{path}

   • 将内容写入指定路径
   • 请求体：{content: string}
   • 返回结果：ok

3. GET /dir/list/{path}

   • 列出指定目录中的所有文件和子目录
   • 返回结果：文件和目录名称的数组

扩展接口

• 支持通过插件系统扩展更多功能，如压缩、加密等。

健康检查

服务器提供一个简单的健康检查端点：

curl http://localhost:8090/health
# 返回：ok

故障排除

常见问题

1. 初始化失败：

   • 确保服务正在运行
   • 检查目标端口是否被占用
   • 验证/health端点是否返回ok

2. 端口冲突：

   • 使用命令lsof -i :<port>检查端口使用情况
   • 使用不同端口启动服务

3. 权限问题：

   • 确保服务器有权限访问请求的文件路径

安全注意事项

此服务器提供对文件系统的直接访问。请考虑以下安全措施：

• 在受信任的网络上运行服务器
• 限制可访问的目录范围
• 考虑在生产环境中实施身份验证
• 监控服务器日志中的可疑活动

潜在改进方向

该MCP服务器可以扩展以下功能：

1. 认证与授权：添加用户认证和基于路径的权限控制
2. 文件监控：实现对文件更改的通知机制
3. 数据压缩：支持gzip等压缩格式
4. 加密传输：默认启用SSL/TLS加密

项目地址

• GitHub

贡献者

感谢以下人员对项目的贡献：

• [Your Name]
• [Contributor Name]

版权所有 (c) 2023, Your Name.