什么是MCP文件系统服务器？

MCP文件系统服务器是一款兼容Model Context Protocol（MCP）的自定义服务器，允许您通过本地文件系统搜索和管理文件。它与OpenAI的Agent SDK集成，支持资源列表获取及文件打开操作。

如何使用MCP文件系统服务器？

首先安装服务器，然后启动服务并配置目标目录。通过Agent SDK调用API接口即可实现文件搜索和管理。

适用场景

适用于需要快速访问本地文件的开发人员、研究人员以及团队协作环境。

主要功能

文件搜索支持在指定目录下进行高效文件搜索。

自动MIME类型检测能够自动识别文件类型，方便后续处理。

灵活配置通过环境变量轻松调整服务器设置。

JSON-RPC协议支持遵循JSON-RPC标准，确保通信稳定性。

优势与局限性

优势

支持多种文件操作，简化文件管理流程。

兼容主流Agent SDK，易于集成。

具备强大的MIME类型检测能力，提升用户体验。

局限性

仅限于本地文件系统访问，无法跨网络操作。

对大规模文件存储可能性能受限。

如何使用

安装服务器

克隆项目代码并安装依赖项。

配置服务器

编辑.env文件，设置搜索目录、主机地址和日志级别。

启动服务器

运行主程序以启动MCP服务器。

使用案例

示例1：搜索文件通过API接口检索目标目录中的所有PDF文档。

示例2：打开文件从Agent SDK请求打开指定文件。

常见问题

如何修改默认搜索目录？

服务器启动失败怎么办？

是否支持远程访问？

🚀 月之MCP文件系统服务器

本项目是一个符合模型上下文协议（MCP）的自定义服务器，可与OpenAI的Agent SDK集成，实现在本地文件系统上进行文件搜索和打开操作，为MCP客户端提供文件资源服务。

🚀 快速开始

本服务器旨在与OpenAI的Agent SDK集成，支持通过MCP协议在本地文件系统上进行文件搜索和打开操作。启动服务器后，它将在指定的IP地址和端口号下运行，准备接收来自MCP客户端的请求。

# 启动服务器
python main.py

✨ 主要特性

📂 通过MCP提供文件系统资源（支持文件搜索和打开操作）
📄 自动检测 MIME 类型
⚙️ 使用环境变量实现灵活配置
📡 支持 JSON-RPC 协议

📦 安装指南

# 克隆仓库
git clone https://github.com/yuutotsuki/tsuki_mcp_filesystem_server.git
cd tsuki_mcp_filesystem_server

# 安装依赖项
pip install -r requirements.txt

🛠️ 配置指南

将 .env.example 复制到 .env 并进行配置：

cp .env.example .env

根据需要编辑 .env 文件：

ROOT_PATH=/path/to/your/search/directory  # 要搜索的目录路径
HOST=127.0.0.1                            # 服务器主机地址
PORT=5001                                 # 服务器端口号
LOG_LEVEL=INFO                            # 日志级别（DEBUG / INFO / WARNING / ERROR）