Calypso Multimodal RAG MCP Server

Claude Desktop、Cursor、エージェントワークフローのための最も簡単なホステッドマルチモーダルRAG MCPサーバー

たった1つのnpxコマンド。Gemini File Search搭載。PDF、スクリーンショット、チャート、図、画像をネイティブに処理し、検証可能な引用を提供します。

Claude、Cursor、Windsurf、カスタムエージェントにホステッドマルチモーダルRAGを追加する最も簡単な方法。

• 超簡単セットアップ: npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-your-key-here

• 真のマルチモーダルRAG: Gemini File Searchを通じてテキストとビジュアルをネイティブに処理

• アップロードとクエリ: 永続的なナレッジファイルとバッチアップロードのための専用ツール

• マルチターン会話: /newリセットによるコンテキストを考慮した回答

• 発見可能なワークフロー: 安全なRAG、アップロード、取り込みフローのためのリソースとプロンプト

GitHub | Docs | Smithery | Official MCP Registry

タグ: multimodal-rag, easiest-mcp-rag, gemini-rag, hosted-rag-mcp, mcp-server

各エージェントやワークフローを一回限りのドキュメント検索スタックに接続する代わりに、このMCPを再利用可能な回答レイヤーへのエージェント向けエントリポイントとして使用します。ソース資料を一度アップロードし、テキストとビジュアルコンテンツを横断して取得し、ユーザーが検証できる証拠付きの回答を返します。

クイックスタート（最も簡単）

# One-liner with npx
npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-your-key-here"

または環境変数を使用:

CALYPSO_API_KEY="sk-..." npx -y @calypsohq/multimodal-rag-mcp-server

次に、以下の設定例を使用して、同じコマンドをClaude Desktop、Cursor、またはSmitheryに追加します。

Related MCP server: RAG-Anything MCP Server

Calypsoを選ぶ理由

Calypsoは、最も簡単なホステッドマルチモーダルRAG MCPサーバーを求めるチーム向けに構築されています。ローカルベクタースタック、Docker Compose、カスタムOCRや画像処理パイプラインは不要で、エージェントが根拠のある質問をする前に準備する必要はありません。

最も簡単なホステッドマルチモーダルRAG MCPサーバーを求めるなら、ここから始めてください。

得られるもの

• マルチターンメモリを備えた本番マルチモーダルRAGエージェント

• 単一ファイルおよびバッチナレッジアップロード用の組み込みアップロードツール

• チームのRAGバリアントとナレッジバケットの自動検出

• ソース参照と取得メタデータ付きの検証可能な引用

• 安全なワークフローのための読み取り専用リソースと再利用可能なプロンプト

マルチモーダルファーストRAGの理由

ほとんどの企業ナレッジはテキストだけではありません。答えはセットアップスクリーンショット、PDFテーブル、製品図、ヘルプセンターページ、レポート内のチャートなどに分散していることがよくあります。Calypsoはその全知識面を単一の取得レイヤーにパッケージ化し、エージェントが一般的なモデルメモリから推測することなく、根拠のある質問をできるようにします。

• ユーザーが実際に頼る形式を検索: ドキュメント、PDF、スクリーンショット、チャート、図、製品画像、サポート記事、マニュアル、ポリシー、FAQ、レポート。

• モデルが書く前に回答をグラウンド: Gemini File Searchが関連するテキストとビジュアルコンテキストを最初に取得し、その後RAGエージェントがそのソース資料から回答します。

• エビデンストレイルを表示: 応答にはソース参照、ページ対応グラウンディング、取得メタデータを含めることができ、ユーザーは信頼する前に検証できます。

• メタデータで取得をスコープ: ワークスペース、チーム、顧客、言語、ファイルタイプ、ステータス、その他のメタデータを使用して、ナレッジベースを複製せずに回答の関連性を維持します。

• 同じナレッジレイヤーをどこでも再利用: Cursor、Claude Desktop、AIエージェント、n8nワークフロー、製品UI、サポートフロー、ウェブサイト体験を同じソースバックレイヤーに接続します。

実際には、エージェントは次のような質問に答えることができます:

• 「このセットアップスクリーンショットと添付のポリシーPDFを説明してください。サポート担当者は次に何をすべきですか？」

• 「このオンボーディングPDFは承認ルールについて何と言っていますか？」

• 「このセットアップ画面が失敗するのはなぜですか？」

• 「価格チャートをプランドキュメントと比較して、適切なティアを推奨してください。」

• 「このサポートチケットに適用されるポリシーを要約してください。」

• 「価格ドキュメントに基づいて、この顧客に合う製品プランはどれですか？」

• 「図示された取り込みフローと取得フローを比較してください。」

このMCPが行うこと

calypso-rag-agentを使用すると:

• 設定されたCalypsoナレッジベースに対して根拠のある質問をする

• オプションのmodel引数で検出された任意のチームRAGバリアントを選択する

• ネイティブの/v1/responses会話モデルを介してマルチターン会話を続ける

• /newで会話コンテキストをリセットする

• calypso-rag-agentを提供するのと同じOpenAI互換Responsesエンドポイントを使用する

• サポートされているCalypsoワークフロー用の組み込みリソースとプロンプトを発見する

要件

• Node.js 18+

• サーバーはAPI呼び出しとSDK互換性のためにWeb Fetch APIプリミティブ（fetch、Headers、Request、Response、FormData、Blob、File）を使用します。パッケージは起動時にNode 18+ Web APIサーフェスの一部のみを公開するMCPランタイムのために欠落しているグローバルをブートストラップします。

• 以下を公開するCalypso APIエンドポイント:

  • POST /v1/responses

  • GET /v1/rag-agent/models

  • GET /v1/knowledge/buckets

  • POST /v1/knowledge/files/upload-session

  • POST /v1/knowledge/files/upload-session/{session_id}/finalize

  • POST /v1/knowledge/files:batch/upload-session

  • POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize

  • GET /v1/knowledge/batches/{batch_id}

• Calypso APIキー（sk-...）

設定

環境変数:

• CALYPSO_API_KEY（必須）

• CALYPSO_API_BASE_URL（オプション、デフォルト https://api.calypso.so/v1）

CLIフラグ:

• --api-key

• --api-base-url

設定の優先順位:

1. CLIフラグ / Smithery提供のコマンド引数

2. 環境変数

3. デフォルトのベースURL（https://api.calypso.so/v1）

npxで実行

npx -y @calypsohq/multimodal-rag-mcp-server --api-key "sk-..."

環境変数で実行

env CALYPSO_API_KEY="sk-..." CALYPSO_API_BASE_URL="https://api.calypso.so/v1" npx -y @calypsohq/multimodal-rag-mcp-server

Cursorで設定

次のような新しいMCPサーバー（コマンドタイプ）を追加します:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

Claude Desktopで設定

1. Claude Desktop MCP設定を開く

Claude Desktopで:

Claude -> Settings -> Developer -> Edit Config

macOSでは、ファイルは通常:

~/Library/Application Support/Claude/claude_desktop_config.json

Claude DesktopはデスクトップMCPサーバーにclaude_desktop_config.jsonを使用します。Claude Codeは~/.claude.jsonやプロジェクトレベルの.mcp.jsonなどの別の設定場所を使用します。

2. Calypso MCPサーバーを追加

これをclaude_desktop_config.jsonに貼り付けます:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    }
  }
}

置き換え:

• sk-your-calypso-api-key

を実際のCalypso APIキーに置き換えます。

3. Claude Desktopを完全に再起動

Claude Desktopを完全に終了し、再度開きます。

ウィンドウを閉じるだけでは不十分です。macOSでは:

Cmd + Q

再起動後、MCPがClaudeに表示され、次のツールが利用可能になります:

• calypso-rag-agent

• calypso-list-buckets

• calypso-upload-file

• calypso-upload-files-batch

オプション: Claude ArtifactsをMacに保存

CalypsoはホステッドマルチモーダルRAGツールを提供します。生成されたレポート、サマリー、CSV、JSONファイル、ウェブ検索アーティファクトをローカルコンピュータに直接書き込むことはありません。

Claude Desktopが生成ファイルをローカルに保存できるようにするには、Calypsoと一緒に標準のfilesystem MCPサーバーを追加し、専用の安全なフォルダに制限します。

最初にフォルダを作成します:

mkdir -p ~/Claude

次に、両方のサーバーをclaude_desktop_config.jsonに追加します:

{
  "mcpServers": {
    "Calypso Multimodal RAG": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "env": {
        "CALYPSO_API_KEY": "sk-your-calypso-api-key",
        "CALYPSO_API_BASE_URL": "https://api.calypso.so/v1"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Claude"
      ]
    }
  }
}

設定変更後、Claude Desktopを完全に終了して再度開きます。

プロンプト例:

Use Calypso for the grounded RAG answer, then save the final report as /Users/yourname/Claude/report.md using the filesystem tool.

安全性のため、filesystemアクセスは~/Claudeなどの専用フォルダにのみ許可し、ホームディレクトリ全体には許可しないでください。

Smithery

サーバーはSmitheryで利用可能で、デスクトップクライアントが使用するのと同じnpxパッケージパスを通じて起動します。

Smitheryユーザー設定:

• calypsoApiKey（必須）

• calypsoApiBaseUrl（オプション、デフォルト https://api.calypso.so/v1）

Smithery起動パスは次と同等です:

npx -y @calypsohq/multimodal-rag-mcp-server --api-key sk-... --api-base-url https://api.calypso.so/v1

calypsoApiBaseUrlは、セルフホストのCalypso互換デプロイメントを対象とする場合にのみ使用します。クラウドデフォルトはオーバーライドする必要はありません。

トラブルシューティング

• APIキーが見つからない: --api-key または CALYPSO_API_KEY を指定してください

• APIホストが誤っている: --api-base-url / CALYPSO_API_BASE_URL が /v1 で終わっていることを確認してください

• セルフホスト型デプロイ: https://api.calypso.so/v1 を使用していない場合のみベースURLを上書きしてください

• Smithery起動時の不一致: 新規クローンから node dist/index.js を実行するのではなく、パッケージ化された npx -y @calypsohq/multimodal-rag-mcp-server パスを使用してください

• FormData is not defined または Headers is not defined: 最新のパッケージにアップグレードしてください。MCPサーバーはアップロードツールが実行される前に、欠落しているWeb Fetch APIグローバルをブートストラップします。

• /mnt/user-data/uploads/... のENOENT: そのパスはホスト型エージェントまたは添付ファイルサンドボックスに属するものであり、必ずしもMCPサーバーに属するものではありません。filePath の代わりに contentBase64 で再試行してください。

• ローカル成果物の保存: Calypsoの回答はClaude Desktopのfilesystem MCPサーバーで使用できますが、最終出力を許可されたローカルパスに保存するようClaudeに明示的に依頼する必要があります。

filePath と contentBase64 の使い分け

ローカルMCPインストールでは filePath を使用してください。Claude DesktopやCursorの設定で、このパッケージを次のようなローカルコマンドで起動する場合が該当します:

npx -y @calypsohq/multimodal-rag-mcp-server

この設定では、MCPサーバープロセスはお使いのマシン上で実行され、同じユーザーアカウントがアクセスできるパスを読み取ることができます。ローカルパスを直接渡してください。サーバーが生のバイトを読み取り、CalypsoのアップロードセッションURLを通じてアップロードします。ローカルファイルをbase64エンコードする必要はありません。

ホスト型またはリモートのMCPクライアントでは contentBase64 を使用してください。Smitheryホスト型サーバー、ブラウザ/クラウドランタイム、生成されたインメモリコンテンツ、エージェントコンテナなどが該当します。これらの環境では、Macやワークステーション上のパスはMCPサーバープロセスから読み取ることができません。

パスが /mnt/user-data/uploads、/mnt/data、/mnt/attachments、またはその他のホスト型サンドボックスプレフィックスで始まる場合、このMCPサーバーが同じサンドボックス内で実行されていない限り、それを filePath として送信しないでください。代わりに contentBase64 またはその他のインラインバイトソースを使用してください。

利用可能なツール

calypso-rag-agent

Calypso RAGエージェントへの直接アクセス。

注意事項:

• 他のペルソナやエージェントへの自動ルーティングは行いません。

• 起動時にAPIキーで利用可能な calypso-rag-agent バリアントを自動的に検出します。

• オプションの model 引数を使用して、calypso-rag-agent:pricing などの名前付きバリアントを選択できます。

• 各モデルバリアントは独自のMCP会話チェーンを保持するため、バリアントを切り替えても誤ったスレッドが継続されることはありません。

• POST /v1/chat/completions ではなく POST /v1/responses を使用します。

• 最初のターンで名前付き会話が作成され、フォローアップターンは previous_response_id でチェーンされます。

• オプションの fileIds は、取得スコープの質問でサポートされています。新しいアップロードは、永続的なナレッジアップロードツールを使用し、質問する前にインデックス作成を待つ必要があります。

• プロンプトとして /new を使用すると、MCP会話をリセットできます。

calypso-list-buckets

設定されたCalypso APIキーに紐づくチームのバケットを一覧表示します。

注意事項:

• GET /v1/knowledge/buckets を使用します。

• team_id は受け付けません。CalypsoはAPIキーからチームスコープを導出します。

• バケットID、スラッグ、名前、ステータス、メンバー数、ソース数、バケットストアの準備状態を返します。

• デフォルトではアクティブなバケットのみを返します。監査やクリーンアップでアーカイブ済みバケットが必要な場合は、includeArchived: true を渡してください。

• 宛先バケットを選択する必要がある場合は、calypso-upload-file または calypso-upload-files-batch の前にこれを使用してください。

• calypso://rag-agent-models は、各RAGバリアントにどのバケットがバインドされているかを回答します。calypso-list-buckets は、APIキーのチームにどのバケットが存在するかを回答します。

例:

{
  "includeArchived": false
}

calypso-get-file

ファイルIDで1つのナレッジファイルのメタデータとインデックス作成ステータスを取得します。

注意事項:

• GET /v1/knowledge/files/{file_id} を使用します。

• calypso-list-buckets の不透明な fileIds を、ファイル名、MIMEタイプ、サイズ、インデックス作成ステータス、バケットごとの同期状態に解決します。

• verify: true を渡すと、プロバイダー（?verify=gemini）に対してクロスチェックします。遅くなりますが、ステータスが古いように見える場合の信頼できる情報源です。

例:

{
  "fileId": "file_123",
  "verify": true
}

calypso-create-bucket

作成してから入力するワークフローのために、空のバケットを作成します。

注意事項:

• POST /v1/knowledge/buckets を使用します（このエンドポイントがデプロイされたバックエンドと、APIキーの knowledge:bucket:create 機能が必要です）。

• サーバーはスラッグを正規化します。衝突すると、型付きの bucket_slug_exists エラーが返されます。

• idempotencyKey のリプレイは、エラーにする代わりに既存のバケットを返します。

• アップロードは bucketSlugs + createMissingBuckets を介してバケットを暗黙的に作成することもできます。このツールは、宛先を先に作成するために存在します。

例:

{
  "name": "Product docs",
  "slug": "product-docs",
  "idempotencyKey": "create-product-docs-1"
}

calypso-create-agent

1つ以上のバケットにバインドされたRAGエージェントバリアントを作成します。

注意事項:

• POST /v1/rag-agent/agents を使用します（このエンドポイントがデプロイされたバックエンドと、APIキーの rag:agent:create 機能が必要です）。

• 成功ペイロードは model で始まります。それをそのまま calypso-rag-agent に渡してください。

• バケットバインディングはサーバー側で検証されます。不明またはアーカイブ済みのバケットは bucket_not_found を返し、エージェントIDの衝突は agent_id_exists を返し、プランのエージェント上限は agent_limit_reached を返します。

• エージェントを作成するとモデルカタログが更新され、MCPの tools/list_changed および resources/list_changed 通知が発行されるため、再接続せずに新しいバリアントを使用できます。

例:

{
  "agentId": "support",
  "name": "Support agent",
  "bucketSlugs": ["product-docs"],
  "idempotencyKey": "create-support-agent-1"
}

calypso-upload-file

ファイルを永続的なバケットバックアップ型ナレッジストアとインデックス作成パイプラインにアップロードします。

注意事項:

• POST /v1/knowledge/files/upload-session を使用し、バイトをストレージに直接アップロードしてから、POST /v1/knowledge/files/upload-session/{session_id}/finalize でファイナライズします。

• アップロードはJSONセッションリクエストと署名付きバイナリ PUT を使用します。マルチパートフォームアップロードではありません。

• チャット添付ファイルの file_id ではなく、ファイルとタスクのメタデータを返します。

• bucketIds、bucketSlugs、または bucket を介して1つのバケット宛先が必要です。

• サーバーがパスを読み取れるローカルClaude Desktop/Cursor MCPインストールでは filePath を使用してください。ローカルパスを読み取れないホスト型またはリモートのMCPクライアントでは contentBase64 を使用してください。

• エージェントが /mnt/user-data/uploads/file.pdf のようなパスを見た場合、それを filePath として送信せず、ファイルバイトを contentBase64 として送信する必要があります。

• オプションの title、tags、metadata、idempotencyKey をサポートします。

• bucketIds または bucketSlugs で既存のバケットにアップロードをルーティングするか、bucket を単一スラッグのショートカットとして使用します。

• アップロード中にCalypsoに欠落した宛先を作成させたい場合は、バケットスラッグとともに createMissingBuckets: true を渡してください。

• オプションで、返す前にインデックス作成が準備完了状態に達するまで待機できます。

例:

{
  "filename": "handbook.pdf",
  "mimeType": "application/pdf",
  "filePath": "/Users/me/Documents/handbook.pdf",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "waitForIndexing": true
}

calypso-upload-files-batch

1回のリクエストで1〜100個のファイルを永続的なナレッジストアにアップロードします。

注意事項:

• POST /v1/knowledge/files:batch/upload-session を使用し、受け入れられた各アイテムをストレージに直接アップロードしてから、POST /v1/knowledge/files:batch/upload-session/{batch_id}/finalize でファイナライズします。

• アップロードはJSONセッションリクエストと署名付きバイナリ PUT を使用します。マルチパートフォームアップロードではありません。

• batchIdempotencyKey が必要です。Calypsoはこれを使用して、再試行用の永続的なバッチIDを導出します。

• すべてのアイテムが独自のバケット宛先を提供しない限り、bucketIds、bucketSlugs、または bucket を介した共有バケット宛先が必要です。

• 共有の bucketIds、bucketSlugs、bucket、createMissingBuckets のデフォルトと、アイテムごとのオーバーライドをサポートします。

• サーバーが各パスを読み取れるローカルClaude Desktop/Cursor MCPインストールでは、アイテムごとの filePath を使用してください。ローカルパスを読み取れないホスト型またはリモートのMCPクライアントでは、アイテムごとの contentBase64 を使用してください。

• clientFileId が省略された場合、Firestoreセーフな client_file_id 値を生成します。

• accepted または queued はアップロードが永続的であることを意味し、必ずしもクエリ可能であることを意味しません。waitForBatchReady: true を使用して GET /v1/knowledge/batches/{batch_id}?include_items=true をポーリングしてください。

• アイテムごとのステータス、bucketSyncStatus、bucketSync を検査して、インデックス済みコンテンツとバケット準備完了の取得を区別してください。

例:

{
  "batchIdempotencyKey": "kb-seed-2026-06-04",
  "bucket": "support-handbook",
  "createMissingBuckets": true,
  "items": [
    {
      "filename": "faq.txt",
      "mimeType": "text/plain",
      "filePath": "/Users/me/Documents/faq.txt"
    }
  ],
  "waitForBatchReady": true
}

利用可能なリソース

calypso://server-info

パッケージバージョン、APIベースURL、トランスポート、認証モデル、公開された機能を含む、読み取り専用のサーバーメタデータ。

calypso://rag-agent-models

設定されたAPIキーから検出された、チームスコープの calypso-rag-agent モデルバリアントの読み取り専用ランタイムカタログ。各バリアントのアクティブな buckets、bucket_ids、missing_bucket_ids が含まれます。検出が利用できない場合、このリソースは基本の calypso-rag-agent にフォールバックします。

calypso://buckets

設定されたAPIキーに紐づくチームのナレッジバケットの読み取り専用ランタイムリスト。アップロード前にバケットID/スラッグとバケットストアの準備状態を検査するために使用します。

calypso://workflows

サポートされているRAGおよびファイルアップロードワークフローの簡潔なガイド。

calypso://security

APIキー、ローカルファイル読み取り、アップロード、ロギングに関する運用上のセキュリティメモ。

利用可能なプロンプト

• calypso-question: calypso-rag-agent 用の根拠に基づくナレッジベースの質問をドラフトします

• calypso-ingestion: 永続的なナレッジストアのアップロードとフォローアップクエリを準備します

• calypso-reset-conversation: /new でクリーンなRAGスレッドを開始します

一般的なワークフロー（コピー/ペースト）

ナレッジ取得

• トピックの要約:

  • キャンペーン承認に関するナレッジベースのガイダンスを要約してください

• 特定の回答を求める:

  • ドキュメントはインデックス作成の再試行について何と言っていますか?

• 2つの概念の比較:

  • 現在のアーキテクチャでファイルインデックス作成と取得実行を比較してください

• 新しいスレッドを開始:

  • /new

マルチターンのフォローアップ

• 前の回答の絞り込み:

  • 取り込みパスのみに焦点を当て、取得は無視してください

• ソースまたは根拠を求める:

  • どのドキュメント化されたコンポーネントが関与し、その理由を説明してください

ナレッジストアのファイルフロー

• バケットの検出:

  • 宛先を選択する前に calypso-list-buckets を呼び出すか、calypso://buckets を読み取ってください

• 永続的なナレッジのアップロード:

  • ファイルペイロードとオプションの title、tags、metadata を指定して calypso-upload-file を呼び出してください

  • ローカルClaude Desktop/Cursor MCPインストールでは filePath を優先し、ローカルパスを読み取れないホスト型またはリモートのMCPクライアントでは contentBase64 を使用してください

• ナレッジをバケットにルーティング:

  • 1つの宛先には bucket: "support-handbook"、複数のスラッグベースの宛先には bucketSlugs、安定したバケットIDがすでにある場合は bucketIds を使用してください

• バケット宛先をオンデマンドで作成:

  • スラッグベースのバケット割り当てを使用していて、宛先がまだ存在しない可能性がある場合は、createMissingBuckets: true を追加してください

• インデックス作成を待機:

  • ナレッジファイルがインデックス作成されるまでツールをブロックしたい場合は、waitForIndexing: true を渡してください

ナレッジストアのバッチフロー

• 多数の永続ファイルをアップロード:

  • ローカルMCPインストールでは items、batchIdempotencyKey、アイテムごとの filePath を指定して calypso-upload-files-batch を呼び出してください。ホスト型またはリモートのMCPクライアントではアイテムごとに contentBase64 を使用してください

• バッチをバケットにルーティング:

  • 共有の bucket、bucketSlugs、bucketIds、または createMissingBuckets をツール呼び出しに置き、必要な場合のみアイテムごとにオーバーライドしてください

• クエリ準備完了を待機:

  • waitForBatchReady: true を使用し、新しいコンテンツをクエリする前に、返されたアイテムステータスとバケット同期フィールドを検査してください

ヒント

• 最初からやり直す: /new を使用してMCP会話をリセットします（新しい conversation_id + クリアされた応答チェーン）。