WASM MCP Server

WASM MCP サーバー

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

特徴

計算ツール

• 基本的な算術演算（加算、減算、乗算、除算）を実行します
• 入力検証とエラー処理
• リアルタイム計算結果

ストレージシステム

• キーバリューストレージ機能
• 文字列キーを使用して値を設定および取得する
• ブラウザセッション内の永続的なストレージ
• テンプレートベースのリソース処理

技術的実装

サーバーコンポーネント

• 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（開発と建築用）

プロジェクト構造

エラー処理

• サーバー初期化エラー
• ツール実行エラー
• リソースアクセスエラー
• 入力検証
• トランスポート層エラー

将来の機能強化

• 追加の計算機操作
• セッションをまたがる永続的なストレージ
• 強化されたUI/UX
• 追加のMCPツールとリソース
• WASMの最適化

発達

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