项目简介
Web Component AI Tools是一个VS Code扩展,旨在通过Model Context Protocol (MCP) 服务器,将工作区和依赖项中的Web组件信息暴露给AI编程助手。它能够自动发现自定义元素、属性和API,使AI代理能够生成更准确、更符合项目实际情况的组件代码。
主要功能点
- 自动组件发现: 自动扫描工作区和依赖包中的'custom-elements.json'清单文件,发现Web组件。
- MCP服务器托管: 启动一个本地MCP服务器,支持HTTP和SSE传输协议,为AI助手提供实时组件信息访问。
- AI助手集成: 与Copilot、Cursor、Windsurf等支持MCP的AI工具兼容,提供丰富的组件上下文。
- 强大的组件工具: 提供搜索组件、获取组件详细信息(包括属性、方法、事件)以及列出所有可用组件等功能。
- 组件资源访问: 通过MCP资源(如'manifest://components')以JSON格式访问所有组件数据。
安装步骤
- 确保您已安装VS Code 1.99.0或更高版本。
- 在VS Code中打开Extensions侧边栏('Ctrl+Shift+X' 或 'Cmd+Shift+X')。
- 搜索 'd13.vscode-web-components-ai'。
- 点击 'Install' 按钮安装此扩展。
服务器配置
当扩展启动后,它会自动在本地启动一个MCP服务器。对于支持自动MCP发现的AI客户端(如VS Code 1.101.0及更高版本中的AI Chat),服务器会自动注册。您可以通过VS Code命令面板运行 'MCP: List Servers' 命令来查看已注册的服务器。
对于需要手动配置的MCP客户端,您需要提供服务器的URL。此扩展支持HTTP和SSE两种传输方式。服务器启动后,您可以获取其地址。以下是标准的MCP服务器配置JSON格式的示例(具体内容可能根据实际启动的端口有所不同):
{ "mcpServers": { "mcp-wcai-http": { "type": "http", "url": "http://127.0.0.1:<port>/mcp" // MCP服务器的HTTP端点URL }, "mcp-wcai-sse": { "type": "sse", "url": "http://127.0.0.1:<port>/sse" // MCP服务器的SSE端点URL } } }
请注意: '<port>' 是服务器启动时分配的端口号。您可以在VS Code中运行 'Web Component AI Tools: Show MCP Server Information' 命令,或通过命令面板运行 'MCP: List Servers' 来获取准确的服务器URL。扩展还会提供一个“Copy Config JSON”选项,可以直接复制预配置的JSON到剪贴板。MCP客户端通常只需要配置服务器的URL和类型即可建立连接,无需理解上述代码细节。
基本使用方法
安装并启动扩展后,AI助手将自动获得您工作区中Web组件的上下文。您可以在AI聊天或代码生成请求中提及您的自定义元素,AI将能够根据其API和文档生成准确的代码。
例如,您可以尝试:
- 在AI聊天中提问:“如何使用我的自定义元素 '<my-button>'?”
- 请求AI生成一段代码,其中包含您项目中定义的Web组件。
- 使用AI助手查询组件的属性、方法和事件,例如:“搜索所有名为'dialog'的组件”,或“获取标签名为'my-card'的组件的详细信息”。
信息
分类
开发者工具