MCP Copilot Instructions

mcp副驾驶说明

用“上下文相关动态指令生成”解决LLM注意力分散问题

挑战

添加详细说明→ 大规模增长→ LLM注意力分散→ 重要指示无效

解决方案

Huge instruction database (.copilot-instructions/, Git managed)
    ↓ Context recognition engine (MCP server)
    ↓ Understand current state/flow from ToDo management
    ↓ Extract only relevant instructions
.github/copilot-instructions.md (dynamically generated)
    ↓ Narrowed down to only necessary instructions for current context
LLM (Focused attention)

目的

• 防止注意力分散导致指令膨胀：保留整体项目知识，同时为法学硕士提供“当前流程”所需的指导
• 依赖上下文的动态生成：从待办事项和任务状态中自动提取当前阶段的适当指令
• Git管理的更改历史记录：使用Git管理整个指令数据库，利用分支策略、审查和回滚

重要：术语定义

在这个项目中，需要仔细注意“用户”是指谁：

• 副驾驶（LLM）: 主要用户 MCP工具。调用工具本身来管理上下文。
• 人力开发人员：使用Copilot的实际开发人员。向副驾驶发出指示并做出最终决定。

除非特别注明，“用户”是指 副驾驶（LLM）本身.

安装

使用npx（推荐）

使用此MCP服务器的最简单方法是通过npx：

npx @mako10k/mcp-copilot-instructions

来自npm

npm install -g @mako10k/mcp-copilot-instructions

来源

git clone https://github.com/mako10k/mcp-copilot-instructions.git
cd mcp-copilot-instructions/server
npm install
npm run build

配置

适用于克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "copilot-instructions": {
      "command": "npx",
      "args": ["@mako10k/mcp-copilot-instructions"]
    }
  }
}

配置文件位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

使用GitHub Copilot获取VS代码

添加到您的VS代码 settings.json:

{
  "github.copilot.chat.mcp.enabled": true,
  "github.copilot.chat.mcp.servers": {
    "copilot-instructions": {
      "command": "npx",
      "args": ["@mako10k/mcp-copilot-instructions"]
    }
  }
}

使用本地安装

如果全局安装或从源安装：

{
  "mcpServers": {
    "copilot-instructions": {
      "command": "node",
      "args": ["/path/to/mcp-copilot-instructions/server/dist/index.js"]
    }
  }
}

快速开始

配置后，重新启动MCP客户端（Claude Desktop或VS Code）。客户端初始化时，服务器将自动启动。

主要文件

• 设计： docs/mcp-server-design.md
• 操作： docs/operation-scenarios.md
• 研究： research/copilot-instructions-research.md
• 说明： .github/copilot-instructions.md

运营政策（摘录）

• 定期审查：每周至少一次，对重要变化立即进行反思
• 变更保留：将对话中的决策反映到指令和上下文中
• 冲突管理：明确废除旧规则并优先考虑新规则

主要功能（第2阶段完成）

• ✅ 目标管理系统：具有自动推进功能的分层目标跟踪，永远不会忘记目标
• ✅ 冲突检测：具有安全分辨率的外部变化检测
• ✅ 历史记录管理：回滚功能，保留30天
• ✅ 动态生成：上下文感知指令过滤
• ✅ 反馈系统：具有硬/软限制的关键反馈跟踪

可用的MCP工具

1. 指导：使用指南和当前状态
2. 项目文本：项目上下文的CRUD操作
3. 指令_结构：带冲突管理的Markdown AST操作
4. change_context：具有自动再生功能的开发上下文切换
5. 反馈：关键反馈跟踪
6. 入职：为现有项目提供迁移支持
7. 目标管理：分层目标跟踪和进度管理

故障排除

服务器未启动

• 确保已安装Node.js 18+： node --version
• 验证npx是否可用： which npx
• 检查MCP客户端日志中的错误消息

工具未出现

• 完全重新启动MCP客户端
• 验证配置JSON语法是否有效
• 检查命令路径是否正确

权限错误

• 在Unix系统上，确保执行权限： chmod +x dist/index.js
• 对于全局安装，可能需要sudo： sudo npm install -g @mako10k/mcp-copilot-instructions

贡献

欢迎投稿！请参阅：

• 设计文件： docs/mcp-server-design.md
• 开发场景： docs/operation-scenarios.md

许可证

MIT许可证-有关详细信息，请参阅许可证文件

下一步开发步骤

• 集成测试和CI/CD设置
• 大型指令集的性能优化
• 增强分析以提高教学效果