AI导哈

文件系统MCP服务器

一个基于FastMCP构建的MCP服务器，将文件系统操作作为工具暴露给LLM应用程序使用。

  • by imaginasean
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 imaginasean/file-system-mcp

使用说明

文件系统MCP

MCP（模型上下文协议）服务器 FastMCP 它将文件系统操作作为LLM应用程序的工具公开。

安装

# Create virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

运行服务器

使用FastMCP CLI（推荐） --用途 fastmcp.json 对于流式HTTP（端口8010）：

fastmcp run

或者明确指定服务器和传输：

fastmcp run server.py --transport streamable-http --port 8010 --path /mcp

或者直接运行脚本 （也使用流式HTTP）：

python server.py

连接至 http://127.0.0.1:8010/mcp关于STDIO或SSE，请参见 FastMCP部署文档.

光标配置

添加到光标MCP设置（例如。 ~/.cursor/mcp.json 或光标设置→ MCP).使用 统一资源定位符 流式HTTP传输：

{
	"mcpServers": {
		"file-system": {
			"url": "http://127.0.0.1:8010/mcp"
		}
	}
}

先启动服务器： fastmcp run （或 python server.py).

工具

工具 说明
read_file 读取文件内容
list_directory 列出目录内容
file_exists 检查路径是否存在
get_file_info 获取文件/目录元数据
write_file 将内容写入文件
create_directory 创建目录
delete_file 删除文件
delete_directory 删除目录
move_file 移动或重命名文件/目录
copy_file 复制文件或目录
search_files 按glob模式搜索文件

相关 MCP