File System MCP服务器安装以及客户端连接配置

版权声明

本文原创作者：谷哥的小弟
作者博客地址：http://blog.csdn.net/lfdfhl

File System MCP服务器概述

File System MCP Server是一种基于模型上下文协议（Model Context Protocol，简称MCP）构建的标准化服务。其主要功能是为AI助手提供一套安全、受控的接口，使其能够与宿主计算机的文件系统进行交互。

File System MCP Server运行于本地环境，作为AI助手与文件系统之间的中间层。它通过MCP协议暴露一系列定义严谨的工具函数，允许AI在预先授权的范围内执行特定的文件操作。典型功能包括遍历目录结构、读取文本文件内容，以及在配置允许的情况下进行文件的创建、写入与修改。所有操作均受限于明确配置的安全边界之内，通常通过指定一个固定的"工作区"或根目录路径来实现。此设计确保了AI助手的访问范围被严格隔离，无法触及系统关键文件或用户私有数据，从而在赋予AI工具调用能力的同时，保障了系统的安全性与用户隐私。

在实际应用场景中，当在Claude Desktop等兼容MCP的客户端中配置此服务器后，用户可直接使用自然语言指令处理文件任务。例如，通过指令"列举项目源码目录下的所有Python文件"或"解析当前目录下的配置文件并总结设置项"，AI助手便可调用该服务器的相应功能，安全地执行操作并返回结果。File System MCP Server的价值在于，以协议化、权限受限的方式扩展了AI助手的能力边界，使其从一个纯粹的对话模型转变为能够安全协助完成基于文件工作的智能体。

File System MCP 服务器安装

请使用以下命令安装File System MCP Server，命令如下：

python 复制代码

npm install -g @modelcontextprotocol/server-filesystem

图示如下：

安装成功后，通过以下命令查看其版本号，命令如下：

python 复制代码

npm list -g --depth=0 | findstr modelcontextprotocol

图示如下：

检查无误后，请利用以下命令启动File System MCP服务器

python 复制代码

npx @modelcontextprotocol/server-filesystem 指定的目录路径

例如：

python 复制代码

npx @modelcontextprotocol/server-filesystem E:\temp

图示如下：

启动成功后请关闭该MCP服务器，避免在地方（例如Spring Boot项目）使用该服务器时发生冲突。

设置文件夹访问权限

为避免File System MCP服务器无权访问本地文件夹，请设置文件夹访问权限；图示如下：

配置File System MCP服务器

Spring AI项目作为客户端需连接已安装的File System MCP服务器时，请添加如下配置：

python 复制代码

# MCP Client Configuration for Filesystem
# IMPORTANT: This path must be consistent with AiConstants.FS_ROOT_PATH
# Current configuration: E:\temp
spring.ai.mcp.client.stdio.connections.filesystem.command=cmd
spring.ai.mcp.client.stdio.connections.filesystem.args[0]=/c
spring.ai.mcp.client.stdio.connections.filesystem.args[1]=npx
spring.ai.mcp.client.stdio.connections.filesystem.args[2]=-y
spring.ai.mcp.client.stdio.connections.filesystem.args[3]=@modelcontextprotocol/server-filesystem
spring.ai.mcp.client.stdio.connections.filesystem.args[4]=E:\\temp