Local-Fe-MCP-Server-Demo（面向用户的步骤书：在VS Code中导入工具→clone→.env→npm run dev）
此自述文件包含 在PowerShell上 git clone 单击功能区上.env 创建单击功能区上npm run dev 启动在…之前0-10步骤对较大场景进行渲染期间已观察到该故障。 （Windows + VS Code + PowerShell 前提）
目标存储库：
- https://github.com/tamuo-0604/Local-File-MCP-Server-Demo
______________________________________________________________________
0.预先准备（允许从VS Code安装）
积分：在本说明书中，尽可能从\*\*VS Code的集成终端（PowerShell）\*\*winget中所述修改相应参数的值。\ VSCode具有集成终端git啊npm中所述修改相应参数的值。
0-1.（任意）未安装VS Code时
如果还没有VSCode，请首先安装VSCode（只有该操作没有VSCode，所以在“外侧”实施）。
winget使用时，可以在PowerShell（或Windows Terminal）上运行以下操作来安装VS Code。
winget install -e --id Microsoft.VisualStudioCodewinget在没有本身的情况下，Windows的 安装工具 （WinGet作为App Installer的一部分提供）。
______________________________________________________________________
0-2.打开VS代码集成终端
- 启动VSCode，并将某个文件夹（例如：
C:\Copilot_Studio_Demo），模板名称将采用不同的格式 - 菜单 查看>航站楼在（或\
Ctrl+\\`）中打开集成终端 - 确认终端外壳是否为PowerShell（即使在不同情况下，只要选择PowerShell即可）
______________________________________________________________________
0-3. winget 确认是否可以使用（从VS Code开始）
在VS代码集成终端上运行：
winget --version显示版本就可以了。\ 如果 winget 如果找不到，请导入Windows的App Installer（WinGet作为App Installer分发）。______________________________________________________________________
0-4.从VSCode安装Node.js（LTS）（winget）
在VS代码集成终端上运行：
winget install -e --id OpenJS.NodeJS.LTS这 OpenJS.NodeJS.LTS（Node.js LTS）安装命令。
安装后重新启动VS代码（或重新建立终端）后确认：
node -v
npm -vnode -v和npm -v（npm与Node.js一起进入）。
例： PS C:\\用户\\tamou>节点-v v24.13.1 PS C:\\Users\\tamuo>npm-v 11.8.0
______________________________________________________________________
0-5.从VSCode安装Git
在VS代码集成终端上运行：
winget install --id Git.Git -e --source winget这 winget install --id Git.Git -e --source winget 在Git公式（Install for Windows）中也有介绍。
安装后重新启动VS代码（或重新建立终端）后确认：
git -vgit -v 显示就可以了
例： PS C:\\用户\\tamou>git-v git版本2.53.0.windows.1
______________________________________________________________________
1.制作作业文件夹
在这里 C:\Copilot_Studio_Demo 使用（在喜欢的地方OK）。
mkdir C:\Copilot_Studio_Demo -ErrorAction SilentlyContinue
cd C:\Copilot_Studio_Demo______________________________________________________________________
2.使用PowerShell克隆存储库并在VSCode中打开（必需）
这个步骤书 PowerShell上的clone 的前提。
#cd C:\Copilot_Studio_Demo
git clone https://github.com/tamuo-0604/Local-File-MCP-Server-Demo.git
cd Local-File-MCP-Server-Demo
code .______________________________________________________________________
3. .env 创建（必需：此步骤说明包括 .env 前提）
存储库正下方（package.json ），模板名称将采用不同的格式 .env 创建并写入设置。
3-1. .env 创建
在VS代码上新建文件 .env 中所述修改相应参数的值。 .env.example 内瓤 .env 中所述修改相应参数的值。
3-2. .env 意味
PORT：待机端口（例如：3110）。一般使用3000的情况比较多，但是在本环境中为了不重复而设定为3110，所以建议不要变更。BASE_DIR：Copilot Studio引用的本地文件夹（例如：./demo-data），模板名称将采用不同的格式。因为已经创建了demo-data文件夹，所以这样下去没有问题。API_KEY-验证密钥（建议将Port Forward更改为Public，以供Copilot Studio参考）
⚠️.env因为可以成为秘密信息，所以请不要共享（共享的话.env.example）。
______________________________________________________________________
4.安装依赖关系（仅第一次）
在VSCode集成终端（PowerShell）上运行：
npm install______________________________________________________________________
5.以开发模式启动（npm run dev 前提）
这个步骤书 npm run dev 中所述修改相应参数的值。
npm run dev「✅ MCP Server listening: http://localhost:3110/mcp的规格化距离的幂函数。 ⚠️ 启动过程中，请勿关闭此终端（关闭后服务器将停止）。
______________________________________________________________________
6.本地沟通确认（是否启动）
端口是 .env 的，之 PORT 中所述修改相应参数的值。
6-1.通过PowerShell确认
Invoke-WebRequest http://localhost:3110/ | Select-Object StatusCode假设出现“The remote server returned an error:（404）Not Found.”，但没有问题。404响应也是服务器启动的证据。
6-2.在浏览器中确认
http://localhost:3110/
假设显示为Not found，但没有问题。
______________________________________________________________________
7.VS Code的Port Forwarding允许外部访问
Copilot Studio等 本地PC以外中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积 端口转发（微软开发隧道） 对较大场景进行渲染期间已观察到该故障。
7-1.Port Forward的步骤（VS Code）
- VSCode下部的 面板 的双曲正切值
- 港口 打开视图（终端 应该在右边）
- 转发端口 ，端口号
3110，然后按Enter。因为要求登录Github，所以登录（没有账户的人请制作）。 - 表示 转发地址复制（URL）使用
7-2.Visibility（公开范围）の注意（重要）
- 默认值为 私人
- 右键单击已创建的行，然后单击港口可见性 的 公共 中所述修改相应参数的值。
⚠️ 公共的话，知道链接的人有可能访问。请勿发布敏感信息或弱认证服务。 ⚠️ 使用公共事业时.env的，之API_KEY必须将值更改为强值，不要与第三方共享。
______________________________________________________________________
8.（仅在需要时）从外部客户端指定MCP端点使用
如果使用端口格式，则目标格式为：。
- 例：
https:///mcp
转发地址复制（URL）后，在末尾 /mcp 请记下来。______________________________________________________________________
9.更新（如果更新了本存储库中的代码，则要遵循最新版本的步骤）
如果已在Git上克隆：
git pull
npm install
npm run dev______________________________________________________________________
10.常见故障排除
10-1.端口正在使用（EADDRINUSE / PORT is already in use）
.env 的，之 PORT 将更改为其他值（例如3111），然后重新启动。
.env（例）
PORT=3111
BASE_DIR=./demo-data
API_KEY=demo-secret再起动：
npm run dev（参考）确认哪个程序在使用（例：3110）
netstat -ano | findstr :3110______________________________________________________________________
10-2. node 啊 git 缺少
winget安装后 重新启动VS代码（或重新打开新的终端）。- 如果这样也不行的话，下面确认：
node -v
npm -v
git --version______________________________________________________________________
10-3.无法访问Port Forward URL
- 服务器是否已启动（
npm run dev是否动作中）确认 - 如果是专用的，访问端可能需要登录
______________________________________________________________________
参考链接（公式）
- Node.js下载（官方）：https://nodejs.org/en/download/
- Git for Windows（通用）：https://git-scm.com/install/windows
- VS Code集成终端：https://code.visualstudio.com/docs/terminal/getting-started
- VS代码端口转发：https://code.visualstudio.com/docs/debugtest/port-forwarding
- VS CodeでMCP serversを使う（注意事项含む）：https://code.visualstudio.com/docs/copilot/customization/mcp-servers
- WinGet（App Installer として提供）：https://learn.microsoft.com/en-us/windows/package-manager/winget/