AI导哈

GitHub Copilot代理配置文件

为GitHub Copilot Chat（代理模式）设计的模型上下文协议（MCP）工具集配置文件集合，旨在使AI辅助明确、安全且上下文适当。

  • by graph-technologies
  • 本地部署
  • 更新于
在 GitHub 查看 graph-technologies/mcp-labs

使用说明

GitHub Copilot代理的MCP配置文件

精心策划的收藏 模型上下文协议（MCP）工具集配置文件 适用于GitHub Copilot Chat（代理模式），旨在使AI辅助明确、安全和上下文适当。

里面是什么

此存储库包含：

  1. default.toolsets.jsonc --五个即用型MCP工具集配置文件，控制副驾驶代理可以访问哪些工具
  2. toolset-profiles.md --关于配置文件本身的完整指南：它们的理念、安全模型、如何使用它们以及企业部署注意事项
  3. mcp-troubleshooting.md --全面的故障排除指南，包括分步诊断、常见陷阱、解决方法和Windows特定提示
  4. mcp-troubleshooting-quick.md --常见MCP问题的快速参考清单

为什么MCP配置文件很重要

当你在代理模式下启用GitHub Copilot时，你就是在让AI助手访问一个强大的工具包。挑战？ 并非每项任务都需要或应该具备每项能力。

MCP工具集配置文件通过让您：

  • 根据上下文匹配能力：使用最小、安全的设置进行日常编辑；在构建和测试时切换到综合开发工具包；在专用配置文件中隔离破坏性操作。
  • 明确权限：可用的工具在代码中声明，像代码一样审查，像代码那样共享——这并不奇怪。
  • 默认情况下提高安全性：将有风险的操作（文件删除、内存图修改）保存在一个单独的选择加入配置文件中，您可以有意切换到该配置文件，然后再切换离开。
  • 加强团队协作：在整个团队中共享一致的、命名的配置文件，这样每个人都知道代理可以做什么。

把它想象成 基于角色的访问控制，适用于您的AI配对程序员.

五个侧面

🟢 graph-basic

日常聊天和编辑的最小、安全默认值

非常适合快速提问、文档更新和小代码更改。仅包括非破坏性工具： search, edit, new, usages, problems以及其他一些。没有文件系统写入，没有删除。

🔵 graph-development

全面、非破坏性的开发工具包

您认真开发工作的日常驱动程序。包括代码编辑、测试、笔记本电脑、Python环境、运行时检查（Console Ninja）、文件系统操作、文档获取（Context7）和非破坏性内存图操作。默认情况下，仍排除内存删除以确保安全。

🟡 graph-data-analysis

笔记本、数据探索和安全阅读

专注于数据科学工作流程：执行笔记本、管理Python包、使用Pylance检查环境以及安全读取文件。不包括文件系统写入和破坏性操作——非常适合探索，没有副作用。

🔴 graph-demolition

孤立的破坏性操作（小心使用）

“紧急情况下打碎玻璃”简介。包含用于删除内存图实体和写入/移动文件的工具。 仅将此配置文件用于需要破坏性操作的特定任务，然后立即切换回。

⚪ graph-none

硬约束：仅建议模式

用于合规性审查或当您希望代理在不执行任何操作的情况下建议更改时，工具集非常有限。仅 search, changes, edit，以及 new.

快速开始

  1. 复制配置文件
    地方 default.toolsets.jsonc 在您的VS Code用户提示目录中：

    • 视窗: %APPDATA%/Code/User/prompts/default-tools.toolsets.jsonc
    • macOS: ~/Library/Application Support/Code/User/prompts/default-tools.toolsets.jsonc
    • Linux: ~/.config/Code/User/prompts/default-tools.toolsets.jsonc

  2. 重新加载VS代码
    跑 Developer: Reload Window 从命令选项板。

  3. 切换到代理模式
    打开GitHub Copilot聊天并选择 代理 模式（非询问模式）。

  4. 选择配置文件
    在Agent界面中按名称选择工具集（例如。， graph-basic 或 graph-development).

  5. 验证
    问： “现在启用了哪些工具？” 以确认配置文件处于活动状态。

何时使用哪个配置文件

任务 个人资料
编写文档、小代码编辑 graph-basic
日常开发、构建、测试 graph-development
数据科学、笔记本电脑、探索数据集 graph-data-analysis
删除文件，删除内存图实体 graph-demolition ⚠️
合规性审查，仅提出模式 graph-none

黄金法则：从以下内容开始 graph-basic。仅在需要额外功能时才切换。完成后切换回来。

理解文档

📘 toolset-profiles.md --哲学与方法

本文件解释了：

  • 为什么存在配置文件：安全性、清晰度、可重复性、治理和性能
  • 它们是如何构建的：JSONC格式、命名约定、工具分组
  • 安全模型：隔离破坏性操作，保持配置文件精简，将更改视为代码
  • 企业部署：共享配置文件、更改控制、权限（以Windows NTFS为例）以及不受控制的配置文件修改的风险
  • 先决条件：哪些工具需要额外的扩展或运行时（Console Ninja、Docker、Python/Pyrance、Context7）

关键见解：配置文件是代码。审查它们，对它们进行版本控制，并控制谁可以修改它们，尤其是在受监管或企业环境中。

🔧 mcp-troubleshooting.md --综合诊断

当MCP服务器未启动或工具未出现时，本指南将引导您完成以下操作：

  1. 配置验证：检查 mcpServers 设置、URL、端口、命令路径
  2. 代理模式验证：确保Copilot聊天处于正确模式
  3. 独立服务器测试：HTTP健康检查、stdio命令验证
  4. 日志分析：在哪里查找错误（输出、DevTools、MCP审计日志）
  5. 常见问题：Windows上的PATH问题、端口冲突、代理拦截、防火墙阻止、TLS证书问题、EPERM错误
  6. 平台特定提示：Windows PATH配置、开发驱动器、WinHTTP代理绕过、防火墙规则

包括系统调试的完整检查表和重置顺序。

⚡ mcp-troubleshooting-quick.md --快速参考

TL；DR版本：快速检查、常见问题、Windows特定命令（代理、防火墙）以及何时升级。

非常适合快速排除故障或作为团队参考卡。

安全与治理

严重警告：MCP配置文件允许从外部源调用函数。一个错误的配置可能会授予代理不安全的功能。

  • 将配置文件视为代码：使用拉取请求、要求审核、维护变更日志
  • 限制写入权限：在共享/企业场景中，将规范配置文件设置为普通用户只读
  • 隔离破坏性工具：将文件删除和内存图修改保存在单独的、名称明确的配置文件中
  • 部署前验证：首先在非生产环境中更改测试配置文件
  • 审计工具的使用：监控MCP工具调用日志，以防意外使用功能

看 toolset-profiles.md 详细的治理建议，包括Windows NTFS权限示例和更改控制工作流。

先决条件和扩展

某些工具需要额外设置：

  • 控制台忍者 （运行时日志）：安装 控制台Ninja扩展
  • 码头工人 （容器命令）：安装 Docker 桌面版 并确保Docker CLI在PATH中
  • Python/Pyrance （Python环境，代码执行）：安装 Python 扩展 和 派兰斯，然后选择口译员
  • 背景7 （文档获取）：需要互联网接入

故障排除

如果工具未出现或MCP服务器无法启动：

  1. 确认您已加入 代理模式 （非询问模式）
  2. 复制/编辑配置文件后重新加载VS代码
  3. 检查是否安装了所需的扩展
  4. 审核日志： View → Output → GitHub Copilot/GitHub Copilot Agent/MCP
  5. 有关详细的诊断，请参阅 mcp-troubleshooting.md

windows用户：特别注意PATH配置、代理绕过设置和防火墙规则——所有这些都在故障排除指南中介绍。

企业部署

对于团队和组织：

  • 版本控制：将此存储库保存在您的内部Git中；通过入职文档分发
  • 变更控制：修改配置文件需要拉取请求和批准
  • 共享配置文件（快速和肮脏）：将只读规范JSONC放在网络共享或内部仓库上；用户将其复制到用户级别设置中
  • 更安全的替代方案：使用企业配置管理（Intune、Jamf、SCCM、Ansible）进行代码审查和批准
  • 代码所有者：特定审批人背后的风险档案（拆迁/管理）

看 企业使用 章节 toolset-profiles.md 有关详细的部署模式和NTFS权限示例。

用例和博客摘要

此存储库演示了：

  • 情境感知AI辅助不同的任务需要不同的能力；配置文件使切换明确且安全
  • 默认安全破坏性行动是孤立的；你故意和暂时地选择加入
  • 团队协作：一致的、命名的配置文件使每个人都能共同理解代理可以做什么
  • 企业准备就绪：配置文件可以通过变更控制进行版本控制、审查、审核和部署
  • 实用故障排除：现实世界的部署挑战（PATH、代理、防火墙、TLS）都有解决方案的记录

无论您是希望组织AI工具包的独立开发人员，标准化Copilot使用的团队负责人，还是计划受控推出的企业架构师，这些配置文件和指南都提供了坚实的基础。

需要帮助？

如果您在环境中部署MCP服务器和配置文件时遇到问题或需要帮助，请联系：

📧 hello@graphtechnologies.xyz
🌐 https://graphtechnologies.xyz

我们提供定制解决方案、企业支持和高级MCP集成。

作者：瑞安·休斯
公司：图形技术
日期：2025年11月5日

免责声明

此存储库中的信息仅用于教育和信息目的。所有代码段、命令和配置示例都是说明性的；它们可能不完整、过时，或者需要根据您的环境进行调整。

作者和Graph Technologies“按原样”提供此材料，不作任何明示或暗示的保证，对因使用或误用内容而产生的任何损害或问题不承担任何责任。

  • 在启用可以修改文件、执行命令或执行破坏性操作的工具之前，始终获得适当的审查和批准。
  • 在受监管或企业环境中，将配置文件更改视为代码（PR、更改日志），并首先在非生产机器上进行验证。
  • 这里没有任何内容构成安全建议；有关政策和批准要求，请咨询您的内部安全/合规团队。

如果您打算将类似的系统部署到生产环境中，请确保您拥有适当的专业知识，进行正式的风险评估，在隔离的沙箱中测试更改，并验证是否符合您组织的政策。

相关 MCP