5分钟上手Wassette：面向初学者的MCP服务器快速启动教程

5分钟上手Wassette：面向初学者的MCP服务器快速启动教程

【免费下载链接】wassetteWassette: A security-oriented runtime that runs WebAssembly Components via MCP项目地址: https://gitcode.com/gh_mirrors/wa/wassette

Wassette是一款面向安全的运行时环境，通过MCP（Modular Component Platform）运行WebAssembly组件。本教程将帮助你在5分钟内快速启动并使用Wassette，无需复杂配置，轻松体验安全高效的WebAssembly组件运行。

准备工作：安装Wassette

一键安装（推荐）

根据你的操作系统选择以下命令，快速安装Wassette：

• Linux/macOS：

  curl -fsSL https://raw.githubusercontent.com/microsoft/wassette/main/install.sh | bash

• macOS（Homebrew）：

  brew tap microsoft/wassette https://github.com/microsoft/wassette brew install wassette

• Windows（WinGet）：

  Invoke-WebRequest -Uri https://raw.githubusercontent.com/microsoft/wassette/main/winget/Microsoft.Wassette.yaml -OutFile Microsoft.Wassette.yaml winget install --manifest Microsoft.Wassette.yaml

验证安装

安装完成后，运行以下命令检查Wassette版本：

wassette --version

如果显示版本号，则安装成功！🎉

步骤1：连接AI代理

Wassette需要与AI代理配合使用，这里以VS Code + GitHub Copilot为例：

通过VS Code安装

点击下方按钮直接在VS Code中安装Wassette服务器：

通过命令行连接

如果偏好命令行操作，运行：

code --add-mcp '{"name":"Wassette","command":"wassette","args":["run"]}'

步骤2：加载WebAssembly组件

连接AI代理后，只需向AI发送指令即可加载组件。例如，加载一个获取天气信息的组件：

Please load the weather component from ghcr.io/microsoft/get-weather-js:latest

AI会自动处理加载过程，你将看到类似以下的成功提示：图：Wassette加载天气组件并接收输入参数的界面

步骤3：使用组件功能

加载完成后，直接向AI提问即可使用组件功能。例如：

What is the current weather in Omaha?

AI会调用已加载的天气组件，返回结果：图：Wassette天气组件返回Omaha的实时温度

进阶尝试：文件系统组件

除了天气组件，你还可以尝试加载文件系统组件，体验Wassette的安全文件操作功能：

Please load the filesystem component from ghcr.io/microsoft/filesystem-rs:latest

加载后，尝试获取文件信息：

Get file info from policy.yaml

Wassette会返回文件的元数据，包括权限、大小和修改时间：图：Wassette文件系统组件展示policy.yaml的元数据信息

常见问题与解决方法

命令未找到（command not found）

• Linux/macOS：确保~/.local/bin在PATH中，运行export PATH="$HOME/.local/bin:$PATH"
• Windows：检查安装目录是否已添加到系统PATH，重启终端或电脑

权限错误（Permission denied）

• Linux/macOS：赋予执行权限：chmod +x ~/.local/bin/wassette
• Windows：以管理员身份运行PowerShell

更多帮助

• 查看官方文档：docs/faq.md
• 组件示例目录：examples/

总结

通过以上步骤，你已成功启动Wassette并体验了WebAssembly组件的加载与使用。Wassette的安全运行时环境和模块化组件设计，让你可以轻松扩展各种功能。立即开始探索更多组件，构建自己的应用吧！🚀

想要深入学习？参考官方开发指南：docs/development/getting-started.md

【免费下载链接】wassetteWassette: A security-oriented runtime that runs WebAssembly Components via MCP项目地址: https://gitcode.com/gh_mirrors/wa/wassette