MCP Server Extension

MCP Server Extension

可在加载时自动启动 MCP 服务器，以发现 GitHub Copilot 工具的简单 VS Code 扩展。

功能

• 扩展加载时自动启动 MCP 服务器
• 为 GitHub Copilot 内置三个工具
• 无需配置

可用工具

• add_numbers - 将两个数字相加
• get_weather - 获取天气预报（模拟）
• list_files - 列出目录中的文件

安装

选项 1：下载预构建扩展

1. 从 releases 或直接从此仓库下载最新的 .vsix 文件
2. 打开 VS Code
3. 按 Ctrl+Shift+P（或在 Mac 上按 Cmd+Shift+P）打开命令面板
4. 输入“Extensions: Install from VSIX...”并选择该项
5. 浏览并选择下载的 .vsix 文件
6. 如有提示，请重启 VS Code

选项 2：从源代码构建

1. 克隆此仓库：

   git clone https://github.com/ranjanbinwani/mcp-server-extension.git
   cd mcp-server-extension
   

2. 安装 VS Code Extension Manager（如果尚未安装）：

   npm install -g vsce
   

3. 打包扩展：

   vsce package
   

4. 按照选项 1 中的步骤安装生成的 .vsix 文件

使用方法

1. 安装扩展 - VS Code 加载时，扩展会自动完成配置
2. 安装后重启 VS Code，确保正确完成配置
3. 打开 GitHub Copilot Chat
4. 提出问题，例如：
   • “将 15 和 27 相加”
   • “纽约未来 3 天的天气预报如何？”
   • “列出当前目录中的文件”

GitHub Copilot 会通过 MCP 协议自动发现并使用这些工具。

工作原理

该扩展会自动：

• 安装所需的 Python 依赖项（fastmcp）
• 配置 MCP 服务器，以便 GitHub Copilot 发现
• 设置相应的 MCP 配置文件
• 通过 stdio 协议提供这些工具

故障排除

如果 GitHub Copilot 未发现这些工具：

1. 完全重启 VS Code
2. 检查 Python 是否已安装 - 确保 Python 3.x 已加入 PATH
3. 手动配置 - 扩展会在以下位置创建配置文件：
   • %USERPROFILE%\.vscode\mcp_servers.json
   • %USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json
4. 独立测试服务器：

   python mcp_server.py
   

   服务器应启动并等待 stdio 输入。

要求

• Python 3.x（已加入 PATH）
• VS Code 1.80.0+
• GitHub Copilot 扩展
• 构建所需：Node.js 和 npm

开发与构建

修改扩展

1. 修改代码 - 根据需要编辑 extension.js、mcp_server.py 或其他文件
2. 测试更改：
   • 在 VS Code 中按 F5，打开扩展开发主机窗口
   • 在新窗口中测试扩展功能
3. 更新版本号：
   • 递增 package.json 中的 version 字段
   • 如果修改了服务器，则更新 mcp_server.py 中的 server_version
4. 构建扩展：

   vsce package
   

   这会根据你的更改创建新的 .vsix 文件
5. 使用上述安装步骤安装并测试新的 .vsix 文件

添加新工具

编辑 mcp_server.py 以添加自己的工具：

@server.tool()
def my_custom_tool(param: str) -> str:
    """Description of what your tool does."""
    return f"Processed: {param}"

添加工具后：

1. 保存文件
2. 独立测试 Python 服务器：python mcp_server.py
3. 重新构建扩展：vsce package
4. 重新安装更新后的 .vsix 文件
5. 重启 VS Code，以重新加载 MCP 配置

发布更改

1. 更新仓库：

   git add .
   git commit -m "Description of your changes"
   git push origin main
   

2. 在提交中包含 .vsix 文件，以便用户下载最新版本
3. 如有重大更新，可创建发行版本（可选）：
   • 前往你的 GitHub 仓库
   • 点击“Releases” → “Create a new release”
   • 将 .vsix 文件作为发行资源上传

许可证

MIT