SSE Calculator MCP Server

SSE Calculator MCP Server

リアルタイム通信に Server-Sent Events（SSE）を使用する、状態を保持する計算サーバーです。このサーバーは、AI アシスタントと統合するために Model Context Protocol（MCP）を実装しています。

機能

• SSE を使用したリアルタイムの計算処理
• 継続的な計算のための状態保持セッション
• すべての計算の履歴を記録
• Web ベースの計算インターフェース
• AI アシスタント向けの MCP 統合

アーキテクチャ

このサーバーは NestJS で構築されており、以下のコンポーネントを実装しています。

• セッションサービス：計算セッションと状態を管理します
• 計算サービス：計算処理を実行します
• SSE コントローラー：クライアント接続とイベントストリーミングを処理します

はじめに

前提条件

• Node.js（v14 以降）
• npm（v6 以降）

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. サーバーを起動します：

npm run start:dev

4. ブラウザーで計算インターフェースを開きます：

http://localhost:3000

API エンドポイント

SSE ストリーム

GET /calculator/stream

SSE 接続を確立し、新しい計算セッションを作成します。

計算

POST /calculator/calculate/:sessionId

指定されたセッションで計算処理を実行します。

リクエストボディ：

{
  "operation": "add", // add, subtract, multiply, divide, clear
  "a": 5,
  "b": 3
}

履歴

GET /calculator/history/:sessionId

指定されたセッションの計算履歴を取得します。

セッション

GET /calculator/sessions

アクティブな計算セッションをすべて取得します。

MCP 統合

このサーバーを MCP サーバーとして使用するには、MCP 設定ファイルに次の設定を追加します。

{
  "mcpServers": {
    "remote-calculator": {
      "url": "http://localhost:3000/calculator/stream",
      "disabled": false,
      "alwaysAllow": [],
      "timeout": 60
    }
  }
}

デプロイ方法

本番環境にデプロイするには、以下の方法を使用できます。

1. Docker：コンテナ化してデプロイするための Dockerfile が用意されています

   • 設定については Dockerfile と docker-compose.yml を参照してください

2. Smithery.ai：GitHub から直接デプロイします

   • 詳細な手順については SMITHERY_DEPLOYMENT.md を参照してください
   • 設定は smithery.json に用意されています

3. Heroku/DigitalOcean：クラウドプラットフォームへのデプロイ

   • 手順については DEPLOYMENT.md を参照してください

4. セルフホスト：SSL 終端とロードバランシングには、NGINX などを使用します

独自の MCP サーバーをホストする

サーバーをデプロイした後、ホストした URL を参照するように MCP クライアントの設定を更新します。

{
  "mcpServers": {
    "remote-calculator": {
      "url": "https://your-deployed-url.com/calculator/stream",
      "disabled": false,
      "alwaysAllow": [],
      "timeout": 60
    }
  }
}

ライセンス

MIT