DeepMyst MCP Server

DeepMyst MCP Server

Claude Desktop および HTTP クライアント向けのインテリジェントな LLM 最適化とルーティング

概要

DeepMyst MCP Server は、Model Context Protocol（MCP）を通じて、DeepMyst と Claude Desktop または任意のクライアントをシームレスに連携させます。この統合により、使い慣れたワークフローを維持しながら、Claude やその他のクライアントで DeepMyst の強力な最適化機能とルーティング機能を活用できます。

主な機能

• トークン最適化 - 応答品質を維持しながらトークン使用量を最大 75% 削減し、API コストを直接抑えます
• スマートモデルルーティング - タスクの要件に基づいて、各クエリに最適な LLM を自動的に選択します
• 機能の組み合わせ - 最適化とルーティングを併用して、効率を最大限に高めます
• 複数のトランスポートに対応 - STDIO（Claude Desktop 向け）または SSE（HTTP クライアント向け）で接続します
• クライアント提供の API キー - サーバーに DeepMyst API キーを保存する必要はありません

仕組み

• トークン最適化：DeepMyst はプロンプト内の冗長な部分を特定し、コンテンツをインテリジェントに圧縮して重要な情報を保持し、文脈上の意味を維持します。品質を損なうことなく、トークン使用量を大幅に削減します。

• スマートルーティング：システムは各クエリのカテゴリ、複雑さのレベル、必要な機能を分析します。重み付けスコアリングシステムを使って、パフォーマンスベンチマーク、トークンコスト、応答レイテンシ、機能の対応状況に基づき、利用可能なモデルを評価します。

インストール

前提条件

• Python 3.8 以降
• UV - 高速な Python パッケージインストーラー
• Claude Desktop - 最新バージョン（またはその他の MCP クライアント）
• DeepMyst API キー（platform.deepmyst.com から取得してください）

インストール手順

1. DeepMyst MCP Server のコードをクローンまたはダウンロードします：

# Create a directory for the server
mkdir DeepMyst-MCP
cd DeepMyst-MCP

# Download the server code
# (Or copy the code from the provided deepmyst_mcp.py file)

2. UV で依存関係をインストールします：

# Create and activate a virtual environment (optional but recommended)
uv venv
source .venv/bin/activate  # On macOS/Linux
# OR
.venv\Scripts\activate     # On Windows

# Install dependencies
uv pip install mcp openai aiohttp uvicorn starlette

サーバーの実行

ローカル環境へのデプロイ

Claude Desktop の場合（STDIO トランスポート）：

python deepmyst_mcp.py --stdio
# OR
uv run deepmyst_mcp.py --stdio

HTTP クライアントの場合（SSE トランスポート）：

python deepmyst_mcp.py --sse
# OR with custom host and port
python deepmyst_mcp.py --sse --host 127.0.0.1 --port 3000

サーバーは明示的なコマンドライン引数に対応しています：

• --stdio - STDIO トランスポートで実行します（Claude Desktop 向け）
• --sse - SSE トランスポートで実行します（HTTP クライアント向け）
• --host HOST - ホストアドレスを指定します（デフォルト：0.0.0.0）
• --port PORT - ポート番号を指定します（デフォルト：8000）
• --debug - デバッグログを有効にします

環境変数も使用できます：

export HOST=127.0.0.1  # Change the host
export PORT=3000       # Change the port
python deepmyst_mcp.py --sse

パブリックサーバー

DeepMyst MCP Server は次の URL で公開されています：https://mcp.deepmyst.com

利用可能なエンドポイント：

• SSE エンドポイント：https://mcp.deepmyst.com/sse
• メッセージエンドポイント：https://mcp.deepmyst.com/messages

Claude Desktop の設定

1. Claude Desktop の設定ファイルを開きます：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. DeepMyst MCP サーバーの設定を追加します：

{
  "mcpServers": {
    "deepmyst": {
      "command": "python",
      "args": [
        "/path/to/deepmyst_mcp.py",
        "--stdio"
      ]
    }
  }
}

3. ファイルを保存して、Claude Desktop を再起動します

ツールと機能

DeepMyst MCP サーバーは、複数の強力なツールを提供します：

1. クエリに最適なモデルを取得
   クエリを分析し、最適なモデルを推奨します。

   Prompt: What's the best model for writing a poem about quantum physics?
   
   Parameters:
   - api_key: your-deepmyst-api-key
   

2. 最適化された補完
   トークン最適化を適用して応答を生成し、コストを削減します。

   Prompt: Use optimized_completion to explain quantum entanglement, with these parameters:
   - api_key: your-deepmyst-api-key
   - model: gpt-4o
   - temperature: 0.7
   

3. 自動ルーティングによる補完
   DeepMyst ルーターを使って最適なモデルを選択し、応答を生成します。

   Prompt: Use auto_routed_completion to generate a Python function with these parameters:
   - api_key: your-deepmyst-api-key
   - base_model: gpt-4o-mini
   

4. スマート補完
   ルーティングと最適化を組み合わせます。まずクエリに最適なモデルを判断し、その後、必要に応じてトークン最適化を適用します。

   Prompt: Use smart_completion to explain how blockchain works, with these parameters:
   - api_key: your-deepmyst-api-key
   - optimize: true
   

5. DeepMyst 補完
   すべてのオプションを設定できる、最も柔軟なツールです。

   Prompt: Use deepmyst_completion to summarize this article, with these parameters:
   - api_key: your-deepmyst-api-key
   - base_model: gpt-4o
   - optimize: true
   - auto_route: false
   

高度なユースケース

複数の LLM による協調的な問題解決

DeepMyst では、複雑な問題を分解し、複数の専門 LLM に割り当てて処理できます。

• 並列処理：複雑なタスクをサブタスクに分割し、異なる LLM が同時に解決できるようにします
• 専門家のアンサンブル：問題の異なる側面を、それぞれの強みを持つモデルに割り当てます（例：創作には GPT-4o、論理的な推論には Claude、数学的な分析には Gemini）
• 合意形成：同じ質問を複数のモデルに送り、回答を統合して、より信頼性の高い回答を生成します
• 思考の連鎖の強化：あるモデルで推論の筋道を生成し、別のモデルで検証または改善します

例：複雑な事業戦略の分析では、DeepMyst が市場調査をデータに強いモデルに、創造的なアイデア出しを生成に特化したモデルに、リスク評価を推論能力に優れたモデルに割り当てることができます。

大規模なコンテキストウィンドウの処理

大規模なドキュメントや複雑な会話を効率的に管理、処理します。

• コンテキストの分割：大規模なドキュメントを扱いやすいセグメントに分割し、それぞれを適切なモデルに送り、結果を統合します
• 段階的な要約：コンテキストウィンドウが小さいモデルで各セクションを要約し、その要約をより広いコンテキストを扱えるモデルに渡します
• 優先度によるフィルタリング：重要度の低い情報を圧縮しながら、最も関連性の高いコンテキストを的確に特定して保持します
• コンテキスト管理：古いターンを動的に圧縮することで、トークン数の上限を超えずに会話履歴を効果的に保持します

例：500 ページの法律文書を分析する場合、DeepMyst は文書を分割し、各セクションを専門の法律分析モデルに送り、コンテキストの上限に達することなく包括的な分析を段階的に構築できます。

インテリジェントなタスクルーティング

各モデルの具体的な能力に基づいて、タスクに最適なモデルを選択します。

• 能力のマッチング：タスクの要件を自動的に特定し、その分野に優れたモデルを割り当てます
• コストの最適化：単純なクエリは効率的で低コストのモデルに送り、複雑なタスクには高性能モデルを割り当てます
• レイテンシの管理：時間制約のあるアプリケーションでは、応答時間の要件に基づいてモデルを選択します
• 専門性に基づくルーティング：特定の分野に関する質問を、その分野で最も優れた性能を発揮するモデルに送ります

例：金融分析のワークフローでは、データ処理を高速で効率的なモデルに、数値分析を数学に特化したモデルに、最終レポートの作成を文章作成能力に優れたモデルに割り当てることができます。

SSE トランスポートによるウェブ連携

SSE トランスポートのサポートにより、DeepMyst MCP をウェブアプリケーションに統合できます。

• リモートアクセス：HTTP 経由で、任意のクライアントから DeepMyst MCP サーバーにアクセスできます
• ウェブアプリケーション：ウェブのフロントエンドやバックエンドと統合できます
• 複数のクライアント：複数のクライアントを同じサーバーに同時接続できます
• API ゲートウェイ：独自のアプリケーションのゲートウェイとして使用できます

例：DeepMyst MCP サーバーに接続するウェブインターフェースを構築し、統一された UI を通じて複数の LLM を利用できるようにします。

対応する LLM プロバイダー

DeepMyst は、以下を含む複数の LLM プロバイダーに対応しています。

• OpenAI：GPT-4o、GPT-4o-mini など
• Anthropic：Claude 3.7 Sonnet、Claude 3.5 Sonnet など
• Google：Gemini 2.0 Flash、Gemini 1.5 Pro など
• Groq：Llama 3.1、Mixtral など

セキュリティに関する考慮事項

API キーの取り扱い

サーバーでは、クライアントが各ツール呼び出しのたびに DeepMyst API キーを提供する必要があります。これには、以下のようなセキュリティ上の影響があります。

• 利点：

  • API キーがサーバーに保存されません
  • 各ユーザーが自分の API キーを使用できます
  • サーバー運用者が API キーにアクセスする必要がありません

• 考慮事項：

  • API キーが会話履歴に表示されます
  • キーは各ツール呼び出しとともに渡されます
  • 適切に設定されていない場合、ログに記録される可能性があります

本番環境でセキュリティを強化するには、次の点にご注意ください。

1. サーバーとの通信には必ず HTTPS を使用してください
2. トークンベースの認証システムの導入を検討してください
3. ログ内のキーをマスキングしてください
4. デプロイ先のプラットフォームに応じた環境固有のセキュリティ対策を講じてください

リソース

• サインアップ：platform.deepmyst.com - DeepMyst アカウントを作成して API キーを取得します
• DeepMyst を試す：ask.deepmyst.com - DeepMyst の機能を体験できるインタラクティブなデモです
• ドキュメント：docs.deepmyst.com - 詳細なガイドと API ドキュメントです
• パブリック MCP サーバー：mcp.deepmyst.com - パブリック DeepMyst MCP サーバーを使用します

トラブルシューティング

よくある問題

Claude にハンマーアイコンが表示されない場合：

• Claude Desktop が最新であることを確認してください
• 設定ファイルに構文エラーがないか確認してください
• Claude Desktop を再起動してください

API キーのエラー：

• DeepMyst API キーが正しいことを確認してください
• 各ツール呼び出しで API キーを指定していることを確認してください
• API キーのパラメーター名に誤字がないか確認してください

サーバー接続の問題：

• すべての依存関係がインストールされていることを確認してください
• deepmyst_mcp.py へのパスが正しいことを確認してください
• サーバーを実行しているターミナルにエラーメッセージが表示されていないか確認してください

SSE トランスポートの問題：

• ポートが別のアプリケーションで使用されていないことを確認してください
• クライアントとサーバー間のネットワーク接続を確認してください
• 接続を妨げる可能性のあるファイアウォールやネットワークの制限がないか確認してください

MCP Inspector の接続：

• 接続には適切な形式を使用してください：npx @modelcontextprotocol/inspector dev http://localhost:8000
• 解析の問題を引き起こす可能性がある --env パラメーターの使用は避けてください

ログ

詳細なトラブルシューティング情報については、DeepMyst MCP サーバーのログを確認してください。ログは、サーバースクリプトと同じディレクトリ内の deepmyst.log に書き込まれます。

--debug フラグを使ってデバッグログを有効にできます：

python deepmyst_mcp.py --stdio --debug

ヘルスチェック

SSE デプロイメントでは、deepmyst://health リソースにアクセスしてサーバーのヘルス状態を確認できます：

Prompt: Check the health status of the DeepMyst MCP server.

パブリックサーバーの使用

パブリック DeepMyst MCP サーバーに接続するには：

Web クライアントの場合

SSE エンドポイントを使ってパブリックサーバーに接続します：

const mcpClient = new McpClient({
  sseEndpoint: "https://mcp.deepmyst.com/sse",
  messageEndpoint: "https://mcp.deepmyst.com/messages"
});

コマンドラインクライアントの場合

SSE トランスポートで MCP CLI を使用します：

mcp connect sse --url https://mcp.deepmyst.com

MCP Inspector の使用

MCP Inspector をパブリックサーバーに接続するには：

npx @modelcontextprotocol/inspector dev https://mcp.deepmyst.com

---

DeepMyst MCP Server は MIT License のもとでライセンスされています