Vscode MCP Extension Demo

数字和计算器-VS代码MCP扩展

此VS Code扩展实现了一个模型上下文协议（MCP）服务器，该服务器提供了一个用于计算三个数字之和的单一工具，并带有顺序提示。

特性

• 单MCP工具: calculate_sum -一种按顺序请求三个数字并返回其总和的工具
• 顺序提示：该工具遵循以下确切流程：

1. “给我第一个数字” 1. “给我第二个数字” 1. “给我第三个数字” 1. 返回所有三个数字的总和

• 局部延伸：完全在VS代码中本地运行

项目结构

extension_demo/
├── src/
│   ├── extension.ts          # Main VS Code extension code
│   └── mcp-server.mjs        # MCP server implementation
├── package.json              # Extension configuration
└── README.md                 # This file

先决条件

• Node.js（建议使用v18.17.0或更高版本）
• VS代码（v1.101.0或更高版本）
• npm

构建和安装指南

1.安装依赖项

npm install

2.编译扩展

npm run compile

3.在VS代码开发模式下打开

1. 在VS Code中打开此项目文件夹
2. 按 F5 或前往 Run > Start Debugging
3. 这将打开一个新的VS Code窗口，其中加载了扩展名

4.使用扩展

一旦扩展在开发窗口中运行：

1. 启用代理模式：打开VS代码命令面板(Ctrl+Shift+P / Cmd+Shift+P)并运行：

   Chat: Enable Agent Mode

1. 使用MCP工具：在VS Code Chat中，您现在可以使用 calculate_sum 工具通过询问：

   "Calculate the sum of three numbers"

然后，该工具将按顺序提示您：

- “给我第一个数字” - “给我第二个数字” - “给我第三个数字”

最后返回总和。

5.替代测试

您也可以直接测试MCP服务器：

node src/mcp-server.mjs

开发脚本

• npm run compile -编译TypeScript
• npm run watch -注意更改并重新编译
• npm run lint -运行ESLint
• npm test -运行测试

建筑

VS代码扩展(src/extension.ts)

• 注册MCP服务器定义提供程序
• 管理MCP服务器进程
• 与VS Code的语言模型API集成

MCP服务器(src/mcp-server.mjs)

• 实现模型上下文协议
• 提供单个 calculate_sum 工具
• 处理序列号提示逻辑
• 返回总和计算结果

MCP工具规格

工具名称: calculate_sum

描述：使用顺序提示计算三个数字的总和

输入架构:

{
  "type": "object",
  "properties": {
    "first_number": { "type": "number" },
    "second_number": { "type": "number" },
    "third_number": { "type": "number" }
  },
  "required": ["first_number", "second_number", "third_number"]
}

行为:

• 如果 first_number 缺失：返回“给我第一个数字”
• 如果 second_number 缺失：返回“给我第二个数字”
• 如果 third_number 缺失：返回“给我第三个数字”
• 如果提供了所有数字：返回“X+Y+Z=RESULT之和”

故障排除

扩展未加载

• 确保在调试模式下运行扩展(F5)
• 检查调试控制台是否有任何错误消息
• 验证是否已安装所有依赖项(npm install)

MCP服务器没有响应

• 检查Node.js是否已正确安装
• 验证 mcp-server.mjs 文件是可执行的
• 在VS代码输出面板中查找错误

聊天工具不可用

• 确保在VS代码中启用代理模式
• 检查MCP服务器是否已正确注册
• 重新启动扩展开发窗口

许可证

本项目作为VS Code MCP扩展开发的示例提供。