https://github.com/microsoft/wassette
Wassette: A security-oriented runtime that runs WebAssembly Components via MCP
https://github.com/microsoft/wassette
capabilities mcp mcp-server oci oci-artifacts permissions wasm wasm-component wasmtime
Last synced: 4 months ago
JSON representation
Wassette: A security-oriented runtime that runs WebAssembly Components via MCP
- Host: GitHub
- URL: https://github.com/microsoft/wassette
- Owner: microsoft
- License: mit
- Created: 2025-07-15T07:48:43.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-01-21T00:33:06.000Z (5 months ago)
- Last Synced: 2026-01-29T01:26:42.575Z (5 months ago)
- Topics: capabilities, mcp, mcp-server, oci, oci-artifacts, permissions, wasm, wasm-component, wasmtime
- Language: Rust
- Homepage: https://microsoft.github.io/wassette/
- Size: 43 MB
- Stars: 817
- Watchers: 7
- Forks: 56
- Open Issues: 66
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Audit: audit.toml
- Security: SECURITY.md
- Notice: NOTICE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-wasm-components - Wassette
- awesome-azure-openai-copilot - wassette - Runs WebAssembly Components as MCP tools with Wasmtime sandbox isolation. (Dev Tools, MCP & Extensions)
- awesome-mcp-servers - Wassette MCP Server - Wassette MCP Server offers a secure runtime for executing WebAssembly (WASM) components via MCP, enabling safe code execution for AI agents. Features sandboxed environments, component model support, and enterprise-grade isolation. Use cases include secure plugin execution for LLMs; differentiates from wasmtime or WASM runtimes by native MCP tooling compatibility. ([Read more](/details/wassette-mcp-server.md)) `Microsoft` `Enterprise` `Webassembly` `Security` `Sandbox` (Microsoft Ecosystem MCP Servers)
- awesome - microsoft/wassette - Wassette: A security-oriented runtime that runs WebAssembly Components via MCP (Rust)
README
Wassette
A security-oriented runtime that runs WebAssembly Components via MCP
[Quick Start] | [FAQ] | [Documentation] | [Releases] | [Contributing] | [Discord]
> [!WARNING]
> **Early Development**: This repository is not production ready yet. It is in early development and may change significantly.
## Why Wassette?
- **Convenience**: Wassette makes it easy to extend AI agents with new tools,
all without ever having to leave the chat window.
- **Reusability**: Wasm Components are generic and reusable;
there is nothing MCP-specific about them.
- **Security**: Wassette is built on the Wasmtime security sandbox, providing
browser-grade isolation of tools.
## Architecture
## Installation
**Quick start:** For Linux/macOS, use our one-liner install script:
```bash
curl -fsSL https://raw.githubusercontent.com/microsoft/wassette/main/install.sh | bash
```
**For complete installation instructions** for all platforms (including Windows, Homebrew, Nix, Docker, and more), see our **[Installation Guide](https://microsoft.github.io/wassette/latest/installation.html)**.
## Using Wassette
With Wassette installed, the next step is to register it with your agent of choice. See our [Quick Start] guide (3 simple steps), or check the [MCP Clients guide](https://microsoft.github.io/wassette/latest/mcp-clients.html) for detailed setup instructions for GitHub Copilot, Cursor, Claude Code, and Gemini CLI.
Once configured, you can start loading WebAssembly components. To teach your agent to tell the time, ask it to load a time component:
```text
Please load the time component from oci://ghcr.io/microsoft/time-server-js:latest
```
Now that the time component is loaded, we can ask your agent to tell you the current time:
```text
What is the current time?
```
The agent will respond with the current time, which is fetched from the time component running in a secure WebAssembly sandbox:
```output
The current time July 31, 2025 at 10:30 AM UTC
```
Congratulations! You've just run your first Wasm Component and taught your agent how to tell time!
## Demo
https://github.com/user-attachments/assets/8e5a371c-ac72-406d-859c-03833ee83963
## Discord
You can join us via the `#wassette` channel on the [Microsoft Open Source Discord](https://discord.gg/microsoft-open-source):
[](https://discord.gg/microsoft-open-source)
## Contributing
Please see [CONTRIBUTING.md][Contributing] for more information on how to contribute to this project.
## License
This project is licensed under the MIT License.
## Trademarks
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft’s Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.
[Quick Start]: https://microsoft.github.io/wassette/latest/quick-start.html
[FAQ]: https://microsoft.github.io/wassette/latest/faq.html
[Documentation]: https://microsoft.github.io/wassette
[Contributing]: CONTRIBUTING.md
[Releases]: https://github.com/microsoft/wassette/releases
[Discord]: https://discord.gg/microsoft-open-source
## Contributors
Thanks to all contributors who are helping shape Wassette into something great.
