WASM MCP 服务器

这是一个模型上下文协议 (MCP) 服务器的概念验证实现，该服务器在 Web 浏览器中的 WebAssembly (WASM) 中运行。 此项目演示了 MCP 工具和资源在浏览器环境中的集成。

功能

计算器工具

• 执行基本算术运算（加法、减法、乘法、除法）
• 输入验证和错误处理
• 实时计算结果

存储系统

• 键值存储功能
• 使用字符串键设置和检索值
• 浏览器会话中的持久存储
• 基于模板的资源处理

技术实现

服务器组件

• server.ts: 具有工具和资源定义的核心 MCP 服务器实现
• main.ts: 客户端集成和 UI 交互处理
• browser-transport.ts: 用于浏览器通信的自定义传输层

架构

• 使用模型上下文协议 SDK 进行服务器实现
• 实现自定义浏览器传输层
• 工具通过回调函数注册
• 资源使用带有参数替换的模板路径

关键概念

1. 工具

   • 使用 server.tool() 注册
   • 通过回调函数执行
   • 使用 Zod 进行模式验证

2. 资源

   • 基于模板的路径（例如，storage://{key}）
   • 通过 readCallback 访问
   • 参数化资源处理

用法

计算器

1. 选择一个操作（加法、减法、乘法、除法）
2. 输入两个数字
3. 单击“计算”以查看结果
4. 错误处理，用于无效输入和除以零

存储

1. 在相应的字段中输入键和值
2. 单击“设置存储”以存储该值
3. 输入一个键，然后单击“获取存储”以检索一个值
4. 提供有关成功操作和错误的反馈

依赖项

• @modelcontextprotocol/sdk
• Zod（用于模式验证）
• TypeScript
• Vite（用于开发和构建）

项目结构

mcp-wasm-poc/
├── src/
│   └── web/
│       ├── server.ts      # MCP 服务器实现
│       ├── main.ts        # 客户端逻辑
│       └── browser-transport.ts # 浏览器传输层
├── index.html            # Web 界面
└── package.json         # 项目依赖

错误处理

• 服务器初始化错误
• 工具执行错误
• 资源访问错误
• 输入验证
• 传输层错误

未来增强

• 其他计算器操作
• 跨会话的持久存储
• 增强的 UI/UX
• 其他 MCP 工具和资源
• WASM 优化

开发

这是一个概念验证实现，演示了使用 WebAssembly 在 Web 浏览器中运行 MCP 服务器的可行性。 该实现侧重于演示核心 MCP 概念，同时保持简单性和清晰性。