
WASM MCP Server

2025.02.21
20
TypeScriptWebAssemblyMCP 服务器浏览器集成其它
mcp-wasm 是一个概念验证(Proof-of-Concept)实现的 WebAssembly (WASM) MCP 服务器,运行在浏览器环境中。该项目展示了在浏览器环境中集成 MCP 工具和资源的能力。
### 核心功能
1. **计算器工具**:支持基本的算术运算(加、减、乘、除),包括输入验证和错误处理,并提供实时计算结果。
2. **存储系统**:提供键值存储功能,支持通过字符串键设置和检索值,并在浏览器会话中实现持久化存储。
3. **技术实现**:基于 Model Context Protocol SDK 实现服务器,包含自定义浏览器传输层、工具注册和资源模板路径处理。
### 适用场景
1. 在浏览器环境中运行 MCP 服务器,展示 MCP 工具的集成能力。
2. 开发需要基本计算和键值存储功能的轻量级 Web 应用。
3. 作为 MCP 协议在 WebAssembly 环境中的可行性验证项目。
View on GitHub
Overview
基本能力
产品定位
mcp-wasm 是一个在浏览器中运行的 WebAssembly MCP 服务器,主要用于展示 MCP 工具和资源在浏览器环境中的集成能力。
核心功能
- 计算器工具
- 支持加、减、乘、除运算
- 输入验证和错误处理
-
实时计算结果
-
存储系统
- 键值存储功能
- 支持通过字符串键设置和检索值
-
浏览器会话内的持久化存储
-
技术实现
- 基于 Model Context Protocol SDK 实现服务器
- 自定义浏览器传输层
- 工具注册和资源模板路径处理
适用场景
- 在浏览器环境中运行 MCP 服务器
- 开发轻量级 Web 应用(需计算和存储功能)
- MCP 协议在 WebAssembly 环境中的可行性验证
工具列表
- Calculator Tool:提供基本算术运算功能。
- Storage System:提供键值存储功能。
常见问题解答
- 错误处理:支持服务器初始化错误、工具执行错误、资源访问错误等。
- 输入验证:计算器工具会对输入进行验证,防止无效操作。
- 存储限制:存储系统仅在浏览器会话内持久化,不支持跨会话持久化。
使用教程
使用依赖
安装以下依赖:
npm install @modelcontextprotocol/sdk zod typescript vite
安装教程
- 克隆项目仓库
- 安装依赖(见上)
- 启动开发服务器:
npm run dev
调试方式
- 使用浏览器开发者工具查看控制台输出
- 检查网络请求和响应
- 查看工具执行和资源访问的日志信息
许可证
None