文章目录
本地mcp-server
本地文件系统操作功能的 MCP server
方式一（每次想使用都得联网）：
{
"mcpServers": {
"filesystem": {
"command": "npx.cmd",
"args": [
"@modelcontextprotocol/server-filesystem",
"D:\\mcp_test"
]
}
}
}
注意上面的方式：
1.首次执行：联网下载包到「临时缓存目录」（Windows 路径：C:\Users\用户名\AppData\Local\npm-cache_npx\生成的一串数字和字母组合的随机数\node_modules\），执行后不会自动将包安装到全局 / 本地 node_modules；
2.断网执行：npx 仍会检查包的最新版本 / 验证缓存有效性，断网时网络请求失败，导致超时
npx 的执行逻辑
首次联网下载后断网再执行，npx 会尝试重新检查/下载包（断网时超时），而非使用本地已存在的文件
1.首次执行：联网下载包到「临时缓存目录」(C:\Users\用户名\AppData\Local\npm-cache_npx\xxxxxx\node_modules@modelcontextprotocol)
执行后不会自动将包安装到全局/本地 node_modules;
2.断网执行：npx 仍会检查包的最新版本/验证缓存有效性，断网时网络请求失败，导致超时。
即使临时缓存目录里有包文件，npx 断网时的「网络校验步骤」也会触发超时，而非直接使用本地缓存。
方式二：
或者（强制 npx 使用本地缓存（不推荐，稳定性差）–亲测可以）
{
"mcpServers": {
"filesystem": {
"command": "npx.cmd",
"args": [
"--offline",
"@modelcontextprotocol/server-filesystem",
"D:\\mcp_test"
]
}
}
}
注：参数--offline： 强制离线模式，仅使用本地缓存(必须本地缓存已经有了)
方式三：手动安装包（替代 npx 临时执行）-- 亲测有效
或者
{
"mcpServers": {
"filesystem": {
"command": "node.exe",
"args": [
"C:\\Users\\用户名\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
"D:\\mcp_test"
]
}
}
}
注：对上方面方式三的解释如下：
核心思路：将 @modelcontextprotocol/server-filesystem 安装到本地（全局 / 项目内），配置中直接调用已安装的包，而非通过 npx 动态下载。
步骤 1：联网时手动安装包（全局 / 项目内）
推荐全局安装（方便任意目录调用）：
CMD下全局安装包（持久化到 npm 全局目录）
C:\Users\用户名>npm install -g @modelcontextprotocol/server-filesystem #确保网络无限制，比如公司内网可能不行，使用手机热点则可以
added 130 packages in 21s
41 packages are looking for funding
run `npm fund` for details
安装后，包会被保存到 Windows 全局路径：C:\Users\用户名\AppData\Roaming\npm\node_modules
可通过 npm root -g 命令查看全局安装目录。
C:\Users\用户名>npm root -g
C:\Users\用户名\AppData\Roamin
1539
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
