Skill MCP (Frontlook Admin)

设置项目技能——MCP服务器

A. 模型上下文协议（MCP）服务器 自动检测项目的技术栈 并将匹配的GitHub Copilot技能文件夹安装到 /skills/, 然后更新 .vscode/settings.json 所以Copilot发现了它们。

作为Docker容器运行（推荐）或直接通过 dotnet run. 通过MCP stdio协议进行通信——不需要网络端口。

______________________________________________________________________

暴露的工具

所有工具都接受这些可选参数：

______________________________________________________________________

检测到的项目类型

检测扫描所有文件（不包括 .git/, node_modules/, bin/, obj/)并且是非排他性的-- 一个项目可以匹配多种类型。

______________________________________________________________________

技能安装

常见技能（每个项目）

git-commit · conventional-commit · create-readme · folder-structure-blueprint-generator · technology-stack-blueprint-generator · context-map · what-context-needed

特定类型技能

中存在的任何技能文件夹 awesome-copilot/skills/ 来源，但不在上面的地图上 当其名称包含与检测到的类型匹配的关键字时，也会自动发现并安装。

______________________________________________________________________

技能来源解析

服务器正在查找 awesome-copilot 按照以下顺序：

1. skillSourcePath 参数（如果提供）
2. AWESOME_COPILOT_REPO_URL 环境变量（设置克隆URL）
3. G:\Repos\frontlook-admin\AI_HELPERS\awesome-copilot
4. G:\Repos\frontlook-admin\awesome-copilot
5. %USERPROFILE%\repos\awesome-copilot
6. %USERPROFILE%\awesome-copilot
7. C:\src\awesome-copilot
8. 自动克隆 从 https://github.com/github/awesome-copilot

在Docker中运行时，主机路径（3-7）不可见；服务器将自动克隆 首次使用，除非您挂载本地克隆（请参阅 在......下面

______________________________________________________________________

先决条件

• .NET 10 SDK --用于本地运行
• 码头工人 --用于集装箱使用
• 带有GitHub Copilot扩展的VS代码（用于MCP发现）
• git 在PATH中--仅在以下情况下需要 awesome-copilot 必须自动克隆

______________________________________________________________________

本地运行（.Net）

cd SkillMcp
dotnet run

服务器从stdin读取MCP消息，并将响应写入stdout。 所有日志都会转到stderr。

______________________________________________________________________

码头工人

本地建设

docker build -t skillmcp:local .

运行--挂载repos驱动器，以便服务器可以读取项目文件

Windows（PowerShell）：

docker run --rm -i -v "G:\Repos:/g/Repos" skillmcp:local

Linux/macOS：

docker run --rm -i -v "$HOME/repos:/repos" skillmcp:local

然后通过 集装箱侧 路径为 targetProject:

targetProject = /g/Repos/your-project          # Windows mount
targetProject = /repos/your-project            # Linux/macOS mount

挂载本地出色的副驾驶克隆（可选，避免自动克隆）

docker run --rm -i \
  -v "G:\Repos:/g/Repos" \
  -v "G:\Repos\frontlook-admin\awesome-copilot:/opt/awesome-copilot:ro" \
  skillmcp:local

通过 skillSourcePath = /opt/awesome-copilot 作为一种工具论证。

通过环境变量覆盖克隆URL

docker run --rm -i \
  -e AWESOME_COPILOT_REPO_URL=https://github.com/your-fork/awesome-copilot \
  skillmcp:local

从GitHub容器注册表中提取

docker pull ghcr.io/frontlook-admin/skillmcp:latest

______________________________________________________________________

VS代码MCP配置

这 .vscode/mcp.json 在这个仓库中，服务器会自动注册。 在VS Code中打开工作区，GitHub Copilot将发现并列出工具。

配置示例：

{
  "servers": {
    "setup-project-skills": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "G:\\Repos:/g/Repos",
        "ghcr.io/frontlook-admin/skillmcp:latest"
      ]
    }
  }
}

Windows路径转换 --服务器自动转换 G:\Repos\foo 到 /g/Repos/foo 以匹配上面的卷装载。 将任一表格作为 targetProject；两者都处理得当。

______________________________________________________________________

GitHub操作——自动Docker发布

工作流程在 构建并推动 GitHub容器注册表（GHCR） 每一次推。 无需配置秘密——它使用内置 GITHUB_TOKEN.

______________________________________________________________________

输出：写什么

之后 setup_project_skills 或 refresh_project_skills 成功运行：

/
  skills/
    git-commit/
    conventional-commit/
    csharp-async/            ← type-specific skills
    ...
    skills.json              ← manifest: detected type + list of installed skills
  .vscode/
    settings.json            ← chat.promptFilesLocations entry added/updated