使用说明

# 副驾驶代理操作MCP服务器

介绍

Copilot AgentOps是一个模型上下文协议（MCP）服务器，提供与副驾驶代理存储库。此服务器使您能够搜索、发现自定义GitHub Copilot指令、提示、代理和集合，并将其直接加载到您的开发环境中。

用。NET 9.0，Copilot AgentOps演示了一种支持STDIO和HTTP通信模式的混合MCP服务器模式，具有灵活的部署选项，包括本地开发、容器化执行和Azure云托管。

特性

🔍 智能搜索：使用关键字和描述搜索GitHub Copilot定制
📥 动态加载：从副驾驶代理操作存储库按需加载自定义指令、提示、代理和集合
🚀 混合式结构：使用相同的代码库作为STDIO或HTTP服务器运行
🐳 集装箱准备就绪：GitHub容器注册表中提供了预构建的Docker镜像
☁️ Azure部署：使用Azure Developer CLI向Azure容器应用程序部署一个命令
🔌 IDE集成：与VS代码代理模式和Visual Studio的本机集成

快速开始

一键安装

将Copilot AgentOps直接安装到IDE中：

Docker快速运行

docker run -i --rm ajilantony/copilot-agentops:latest

可用工具和提示

类型	名称	描述	IDE中的用法
🔧 工具	`search_instructions`	按关键字搜索自定义说明、提示和代理	`#search_instructions`
🔧 工具	`load_instruction`	加载和检索特定自定义的完整内容	`#load_instruction`
💬 提示	`get_search_prompt`	获取用于搜索自定义项的结构化提示模板	`/mcp.copilot-agentops.get_search_prompt`

运作原理

搜索：使用 search_instructions 根据您的需求查找相关的GitHub Copilot定制
审查：浏览显示标题、描述、类型（指令/提示/代理）和可用性的搜索结果
负载：使用选择和加载特定自定义项 load_instruction 获取完整的降价内容
应用：将加载的内容保存到本地 .github/ 在项目中立即使用的目录

用例

对于开发者

发现最佳实践：为您的技术栈找到经过验证的Copilot定制
Bootstrap项目：快速将特定于域的代理和说明添加到新项目中
保持更新：从社区访问最新的Copilot自定义设置
比较实施：在创建自己的自定义项之前，先查看存在哪些自定义项

对于团队

标准化工作流程：共享和同步团队副驾驶配置
知识共享：通过精心策划的说明分发最佳实践
入职：帮助新团队成员发现可用的Copilot资源

工作流示例

1. Search for Python testing instructions:
   > #search_instructions keywords: python testing

2. Review results showing available pytest, unittest, and TDD instructions

3. Load a specific instruction:
   > #load_instruction filename: pytest-best-practices.instructions.md

4. Save to your project:
   Save content to .github/instructions/pytest-best-practices.instructions.md

5. Copilot now uses these instructions in your project!

建筑

Copilot AgentOps实现了混合MCP服务器架构：

┌─────────────────────────────────────────────────────────────┐
│                   MCP Client (VS Code/Visual Studio)         │
└─────────────────────────┬───────────────────────────────────┘
                          │
                ┌─────────┴──────────┐
                │  STDIO or HTTP     │
                └─────────┬──────────┘
                          │
┌─────────────────────────┴───────────────────────────────────┐
│              Copilot AgentOps MCP Server                     │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  Tools: search_instructions, load_instruction        │  │
│  │  Prompts: get_search_prompt                          │  │
│  │  Service: MetadataService (metadata caching)         │  │
│  └──────────────────────────────────────────────────────┘  │
└─────────────────────────┬───────────────────────────────────┘
                          │
                ┌─────────┴──────────┐
                │  GitHub Repository │
                │  copilot-agentops  │
                └────────────────────┘

关键组件

元服务：缓存并提供副驾驶代理操作存储库中的元数据
元数据工具：执行搜索和加载操作
MetadataPrompt：提供结构化提示模板
混合运行时：同时支持STDIO（进程通信）和HTTP（REST API）模式

部署选项

1.地方发展（STDIO）

cd hybridapp
dotnet run --project ./src/CopilotAgentOpsMcp.HybridApp

2.本地HTTP服务器

dotnet run --project ./src/CopilotAgentOpsMcp.HybridApp -- --http
# Server runs at http://localhost:5250

3.集装箱（STDIO）

docker build -f Dockerfile.copilot-agentops -t copilot-agentops:latest .
docker run -i --rm copilot-agentops:latest

4.容器（HTTP）

docker run -i --rm -p 8080:8080 ajilantony/copilot-agentops:latest --http
# Server runs at http://localhost:8080

5.Azure容器应用程序

cd hybridapp
azd auth login
azd up

部署后，获取服务器URL：

azd env get-value AZURE_RESOURCE_MCP_COPILOT_AGENTOPS_FQDN

配置

通过将相应的配置复制到来配置MCP服务器 .vscode/mcp.json:

# For local STDIO mode
cp hybridapp/.vscode/mcp.stdio.local.json .vscode/mcp.json

# For local HTTP mode
cp hybridapp/.vscode/mcp.http.local.json .vscode/mcp.json

# For containerized mode
cp hybridapp/.vscode/mcp.stdio.container.json .vscode/mcp.json

# For Azure deployment
cp hybridapp/.vscode/mcp.http.remote.json .vscode/mcp.json

然后重新启动VS Code或从命令面板重新加载MCP服务器(MCP: List Servers).

先决条件

项目结构

hybridapp/
├── src/
│   └── CopilotAgentOpsMcp.HybridApp/
│       ├── Program.cs                      # Application entry point
│       ├── Configurations/                 # App settings
│       ├── Models/                         # Data models
│       ├── Services/                       # MetadataService implementation
│       ├── Tools/                          # MCP tools
│       ├── Prompts/                        # MCP prompts
│       └── metadata.json                   # Cached repository metadata
├── infra/                                  # Azure infrastructure (Bicep)
├── .vscode/                                # MCP configuration templates
└── README.md                               # Sample documentation