Tsuki MCP Filesystem Server

@yuutotsuki

代码仓库

基本信息

分类

文件与存储

许可证

MIT license

传输方式

stdio

作者

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` に対応しています。

Tsuki MCP Filesystem Server 配置

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

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

Tsuki MCP Filesystem Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

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`.