WASM MCP サーバー

ウェブブラウザ内でWebAssembly (WASM) で実行されるModel Context Protocol (MCP) サーバーの概念実証実装です。このプロジェクトは、ブラウザ環境におけるMCPツールとリソースの統合を実証します。

特徴

計算ツール

• 基本的な算術演算（加算、減算、乗算、除算）を実行します

• 入力検証とエラー処理

• リアルタイム計算結果

ストレージシステム

• キーバリューストレージ機能

• 文字列キーを使用して値を設定および取得する

• ブラウザセッション内の永続的なストレージ

• テンプレートベースのリソース処理

Related MCP server: MCP Communication Server

技術的実装

サーバーコンポーネント

• server.ts : ツールとリソースの定義を含むコア MCP サーバーの実装

• main.ts : クライアント側の統合とUIインタラクションの処理

• browser-transport.ts : ブラウザ通信用のカスタムトランスポート層

建築

• サーバーの実装にはモデルコンテキストプロトコルSDKを使用します

• カスタムブラウザトランスポート層を実装する

• ツールはコールバック関数に登録されます

• リソースはパラメータ置換によるテンプレートパスを使用します

重要な概念

1. ツール

   • server.tool()を使用して登録されました

   • コールバック関数経由で実行

   • Zodを使用したスキーマ検証

2. リソース

   • テンプレートベースのパス（例： storage://{key} ）

   • readCallback経由でアクセス

   • パラメータ化されたリソース処理

使用法

電卓

1. 演算を選択します（加算、減算、乗算、除算）

2. 2つの数字を入力してください

3. 「計算」をクリックして結果を確認してください

4. 無効な入力とゼロ除算のエラー処理

ストレージ

1. それぞれのフィールドにキーと値を入力します

2. 「保存設定」をクリックして値を保存します

3. キーを入力し、「ストレージを取得」をクリックして値を取得します

4. 成功した操作とエラーに関するフィードバックが提供されます

依存関係

• @モデルコンテキストプロトコル/sdk

• Zod（スキーマ検証用）

• タイプスクリプト

• Vite（開発と建築用）

プロジェクト構造

mcp-wasm-poc/
├── src/
│   └── web/
│       ├── server.ts      # MCP server implementation
│       ├── main.ts        # Client-side logic
│       └── browser-transport.ts # Browser transport layer
├── index.html            # Web interface
└── package.json         # Project dependencies

エラー処理

• サーバー初期化エラー

• ツール実行エラー

• リソースアクセスエラー

• 入力検証

• トランスポート層エラー

将来の機能強化

• 追加の計算機操作

• セッションをまたがる永続的なストレージ

• 強化されたUI/UX

• 追加のMCPツールとリソース

• WASMの最適化

発達

これは、WebAssemblyを用いてウェブブラウザ上でMCPサーバーを実行することの実現可能性を示す概念実証実装です。この実装は、シンプルさと明瞭さを維持しながら、MCPの中核概念を示すことに重点を置いています。