Local File MCP Server Demo

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.VisualStudioCode

• winget 在没有本身的情况下，Windows的 安装工具 （WinGet作为App Installer的一部分提供）。

______________________________________________________________________

0-2.打开VS代码集成终端

1. 启动VSCode，并将某个文件夹（例如：C:\Copilot_Studio_Demo），模板名称将采用不同的格式
2. 菜单 查看>航站楼在（或\Ctrl+\\`）中打开集成终端
3. 确认终端外壳是否为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 -v

node -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 -v

git -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）

1. VSCode下部的 面板 的双曲正切值
2. 港口 打开视图（终端 应该在右边）
3. 转发端口 ，端口号 3110 ，然后按Enter。因为要求登录Github，所以登录（没有账户的人请制作）。
4. 表示 转发地址复制（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/