tsuki_mcp_filesystem_server

Name: tsuki_mcp_filesystem_server
Author: yuutotsuki

@yuutotsuki

关于 tsuki_mcp_filesystem_server

A custom MCP-compatible server for searching local filesystem files. Works with OpenAI's Agent SDK via the resources/list method. ローカルファイルの検索を行う、自作のMCP対応サーバーです。 Agent SDK の `resources/list` に対応しています。

基本信息

分类

文件与存储

许可证

MIT license

运行时

python

传输方式

stdio

发布者

yuutotsuki

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "tsuki_mcp_filesystem_server": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is tsuki_mcp_filesystem_server?

tsuki_mcp_filesystem_server is a custom Model Context Protocol (MCP) server that provides file search and open operations over the local filesystem. It is designed for integration with OpenAI's Agent SDK, enabling AI agents to list and open local files via the resources/list method.

How to use tsuki_mcp_filesystem_server?

Clone the repository, install dependencies with pip install -r requirements.txt, copy .env.example to .env, configure the ROOT_PATH, HOST, PORT, and LOG_LEVEL settings, then start the server with python main.py. The server listens for MCP client requests on the configured host and port.

Key features of tsuki_mcp_filesystem_server

Provides file system resources via MCP protocol
Supports file search and open operations
Automatic MIME type detection
Flexible configuration through environment variables
Implements JSON-RPC protocol

Use cases of tsuki_mcp_filesystem_server

Enabling OpenAI Agent SDK to search and open local files
Exposing a local directory's file list to MCP-compatible clients
Building AI-powered tools that need local filesystem access
Prototyping agentic workflows with file retrieval capabilities

FAQ from tsuki_mcp_filesystem_server

What transport or protocol does tsuki_mcp_filesystem_server use?

It uses the JSON-RPC protocol over TCP/IP, listening on a configurable host and port.

What runtime or dependencies are required?

Python 3 and the packages listed in requirements.txt are required.

What configuration is needed before starting the server?

You must set the ROOT_PATH environment variable (or in .env) to specify the directory to be searched. Optionally, set HOST, PORT, and LOG_LEVEL.

How does this server compare to other MCP file servers?

The README states it is a custom, lightweight server focused on file search and open operations via the resources/list method.

Where does the file data live?

The server only accesses files under the configured ROOT_PATH directory on the local filesystem. No external storage is used.

文件与存储分类下的更多 MCP 服务器

Filesystem MCP Server SSE

ysthink

The SSE version of the MCP service is modified from the Filesystem MCP server

Filesystem

chrisdoc

Manage your Hevy workouts, routines, folders, and exercise templates. Create and update sessions faster, organize plans, and search exercises to build workouts quickly. Stay synced with changes so your training log is always up to date.

310

MCP File System Server

MarcusJellinghaus

MCP Workspace Server: A secure Model Context Protocol server providing file, git, and GitHub tools for AI assistants within a sandboxed project directory.