AI导哈

本地文件MCP服务器演示

一个基于VS Code的本地文件MCP服务器演示项目，用于通过PowerShell进行克隆、配置和运行。

  • by tamuo-0604
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 tamuo-0604/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://<your-forwarded-address>/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/

相关 MCP