WASM MCP Server

WASM MCP Server

site icon
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 工具和资源在浏览器环境中的集成能力。

核心功能

  1. 计算器工具
  2. 支持加、减、乘、除运算
  3. 输入验证和错误处理
  4. 实时计算结果

  5. 存储系统

  6. 键值存储功能
  7. 支持通过字符串键设置和检索值
  8. 浏览器会话内的持久化存储

  9. 技术实现

  10. 基于 Model Context Protocol SDK 实现服务器
  11. 自定义浏览器传输层
  12. 工具注册和资源模板路径处理

适用场景

  1. 在浏览器环境中运行 MCP 服务器
  2. 开发轻量级 Web 应用(需计算和存储功能)
  3. MCP 协议在 WebAssembly 环境中的可行性验证

工具列表

  1. Calculator Tool:提供基本算术运算功能。
  2. Storage System:提供键值存储功能。

常见问题解答

  1. 错误处理:支持服务器初始化错误、工具执行错误、资源访问错误等。
  2. 输入验证:计算器工具会对输入进行验证,防止无效操作。
  3. 存储限制:存储系统仅在浏览器会话内持久化,不支持跨会话持久化。

使用教程

使用依赖

安装以下依赖:

npm install @modelcontextprotocol/sdk zod typescript vite

安装教程

  1. 克隆项目仓库
  2. 安装依赖(见上)
  3. 启动开发服务器:
npm run dev

调试方式

  1. 使用浏览器开发者工具查看控制台输出
  2. 检查网络请求和响应
  3. 查看工具执行和资源访问的日志信息

许可证

None