mcp server配置及使用总结

本地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