🐙 模块 4：实用 MCP 开发 - 自定义 GitHub 克隆服务器

Duration Difficulty MCP VS Code GitHub Copilot

⚡ 快速开始： 只需30分钟，构建一个生产级的 MCP 服务器，实现 GitHub 仓库克隆和 VS Code 集成的自动化！

🎯 学习目标

完成本实验后，您将能够：

✅ 创建适用于真实开发流程的自定义 MCP 服务器
✅ 通过 MCP 实现 GitHub 仓库克隆功能
✅ 将自定义 MCP 服务器与 VS Code 和 Agent Builder 集成
✅ 使用 GitHub Copilot Agent 模式配合自定义 MCP 工具
✅ 在生产环境中测试和部署自定义 MCP 服务器

📋 先决条件

完成实验 1-3（MCP 基础和高级开发）
拥有 GitHub Copilot 订阅（免费注册）
安装了带有 AI Toolkit 和 GitHub Copilot 扩展的 VS Code
安装并配置好 Git CLI

🏗️ 项目概述

真实开发挑战

作为开发者，我们经常使用 GitHub 克隆仓库并在 VS Code 或 VS Code Insiders 中打开。这个手动流程包括：

打开终端/命令提示符
切换到目标目录
执行 git clone 命令
在克隆的目录中打开 VS Code

我们的 MCP 解决方案将这一流程简化为一个智能命令！

你将构建的内容

一个 GitHub 克隆 MCP 服务器（git_mcp_server），具备以下功能：

功能	描述	优势
🔄 智能仓库克隆	验证后克隆 GitHub 仓库	自动错误检查
📁 智能目录管理	安全检查并创建目录	防止覆盖已有内容
🚀 跨平台 VS Code 集成	在 VS Code/Insiders 中打开项目	流程无缝衔接
🛡️ 强健的错误处理	处理网络、权限和路径问题	生产环境级别的可靠性

📖 逐步实现

第 1 步：在 Agent Builder 中创建 GitHub Agent

通过 AI Toolkit 扩展启动 Agent Builder
使用以下配置创建新 agent：
```
Agent Name: GitHubAgent
```
初始化自定义 MCP 服务器：
- 进入工具 → 添加工具 → MCP 服务器
- 选择 “创建新的 MCP 服务器”
- 选择 Python 模板 以获得最大灵活性
- 服务器名称： git_mcp_server

第 2 步：配置 GitHub Copilot Agent 模式

在 VS Code 中打开 GitHub Copilot（Ctrl/Cmd + Shift + P → “GitHub Copilot: Open”）
在 Copilot 界面选择 Agent 模型
选择 Claude 3.7 模型，以增强推理能力
启用 MCP 集成以访问工具

💡 专业提示： Claude 3.7 对开发流程和错误处理模式有更深刻的理解。

第 3 步：实现核心 MCP 服务器功能

使用以下详细提示配合 GitHub Copilot Agent 模式：

Create two MCP tools with the following comprehensive requirements:

🔧 TOOL A: clone_repository
Requirements:
- Clone any GitHub repository to a specified local folder
- Return the absolute path of the successfully cloned project
- Implement comprehensive validation:
  ✓ Check if target directory already exists (return error if exists)
  ✓ Validate GitHub URL format (https://github.com/user/repo)
  ✓ Verify git command availability (prompt installation if missing)
  ✓ Handle network connectivity issues
  ✓ Provide clear error messages for all failure scenarios

🚀 TOOL B: open_in_vscode
Requirements:
- Open specified folder in VS Code or VS Code Insiders
- Cross-platform compatibility (Windows/Linux/macOS)
- Use direct application launch (not terminal commands)
- Auto-detect available VS Code installations
- Handle cases where VS Code is not installed
- Provide user-friendly error messages

Additional Requirements:
- Follow MCP 1.9.3 best practices
- Include proper type hints and documentation
- Implement logging for debugging purposes
- Add input validation for all parameters
- Include comprehensive error handling

第 4 步：测试你的 MCP 服务器

4a. 在 Agent Builder 中测试

启动 Agent Builder 的调试配置
使用以下系统提示配置你的 agent：

SYSTEM_PROMPT:
You are my intelligent coding repository assistant. You help developers efficiently clone GitHub repositories and set up their development environment. Always provide clear feedback about operations and handle errors gracefully.

使用真实用户场景进行测试：

USER_PROMPT EXAMPLES:

Scenario : Basic Clone and Open
"Clone {Your GitHub Repo link such as https://github.com/kinfey/GHCAgentWorkshop
 } and save to {The global path you specify}, then open it with VS Code Insiders"

Agent Builder Testing