File system MCP

基本能力

产品定位

Filesys 是一个轻量级的文件系统 MCP 服务器，专注于安全地暴露和管理指定目录中的文件内容和元数据，同时支持通过自然语言交互（如 Claude AI）进行文件操作。

核心功能

1. 文件列表：列出指定目录中的所有可见文件。
2. 文件读取：读取指定文件的内容及其元数据（如文件大小和最后修改时间）。
3. 自然语言交互：通过 Claude AI 进行文件操作，支持自然语言指令（如“列出文件”或“读取文件”）。
4. 安全性：验证文件路径，防止目录遍历攻击。

适用场景

1. 开发环境：快速访问和管理项目文件。
2. 自动化工具：与其他工具（如 Claude AI）集成，实现自动化文件操作。
3. 安全文件访问：限制文件访问范围，防止未经授权的操作。

工具列表

1. Claude Tool Client：作为与 Filesys MCP 服务器交互的桥梁，将函数调用转换为 MCP 请求并解析响应。
2. Claude Interaction Script：设置 Anthropic 客户端，定义 Claude Tools，并运行命令行对话循环。
3. Unit Tests：测试文件列表和读取功能。

常见问题解答

1. 如何配置目录？：修改 config/config.json 文件中的 directory 字段。
2. 如何启动服务器？：运行 python run.py。
3. 如何与 Claude 交互？：运行 python interact_with_claude.py 并输入自然语言指令。
4. 如何测试功能？：运行 python claude_tool_client.py 或 python -m unittest discover tests。

使用教程

使用依赖

1. Python：确保已安装 Python。
2. Anthropic API Key：需要提供 API 密钥以使用 Claude AI 功能。

安装教程

1. 克隆仓库： bash git clone https://github.com/iBz-04/Filesys.git
2. 进入项目目录： bash cd Filesys
3. 创建虚拟环境（推荐）： bash python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate
4. 安装依赖： bash pip install -r requirements.txt
5. 配置 API 密钥：
6. 创建 .env.local 文件并添加： env ANTHROPIC_API_KEY=your_api_key_here

调试方式

1. 启动服务器： bash python run.py
2. 与 Claude 交互： bash python interact_with_claude.py
3. 测试功能： bash python claude_tool_client.py python -m unittest discover tests

许可证

None