tsuki_mcp_filesystem_server
2025.04.20
0
Python文件管理文件管理
tsuki_mcp_filesystem_server 是一个自定义的 MCP（Model Context Protocol）兼容服务器，专为与 OpenAI 的 Agent SDK 集成而设计。它支持通过 MCP 协议提供本地文件系统的文件搜索和打开操作，具备自动 MIME 类型检测、灵活的配置选项和 JSON-RPC 协议支持。
View on GitHub
Overview
基本能力
产品定位
tsuki_mcp_filesystem_server 是一个用于本地文件系统搜索和管理的 MCP 兼容服务器，旨在与 OpenAI 的 Agent SDK 集成，提供文件资源的搜索和操作功能。
核心功能
- 通过 MCP 协议提供文件系统资源（支持文件搜索和打开操作）
- 自动 MIME 类型检测
- 通过环境变量进行灵活配置
- 支持 JSON-RPC 协议
适用场景
- 本地文件系统的搜索和管理
- 与 OpenAI Agent SDK 集成的文件操作
- 需要自动 MIME 类型检测的文件管理系统
工具列表
resources/list: 获取目标目录中的文件列表
常见问题解答
无明确常见问题解答部分。
使用教程
使用依赖
安装依赖项的命令如下：
pip install -r requirements.txt
安装教程
- 克隆仓库：
git clone https://github.com/yuutotsuki/tsuki_mcp_filesystem_server.git
cd tsuki_mcp_filesystem_server
- 安装依赖项：
pip install -r requirements.txt
- 配置环境变量：
cp .env.example .env
编辑 .env 文件，设置以下参数：
ROOT_PATH=/path/to/your/search/directory
HOST=127.0.0.1
PORT=5001
LOG_LEVEL=INFO
调试方式
启动服务器的命令如下：
python main.py
服务器将在指定的主机和端口上启动，等待 MCP 客户端的请求。