Repolode
投稿する
Dicklesworthstone

Dicklesworthstone/ultimate_mcp_client

stdio、SSE、streaming-HTTP経由でAIモデルとMCPサーバーを接続する、対話型CLIとWeb UIを備えた非同期Pythonクライアント。

GitHub で見る
スター
171
フォーク
23
未解決の Issue
0
最終コミット
8 日前

これは何？

Ultimate MCP Clientは、AIモデルが外部のツール、リソース、プロンプトにアクセスする方法を標準化するModel Context Protocol（MCP）用のPythonクライアントです。Anthropic SDKを通じてClaudeモデルを、ローカルのstdioプロセスとして動作するMCPサーバーや、リモートのSSEおよびstreaming-HTTPエンドポイントに接続し、各ツールを提供するサーバーにツール呼び出しを振り分けます。

同じコアを使う2種類のフロントエンドを提供します。FastAPI、WebSockets、Alpine.js、DaisyUIで構築されたWeb UIと、TyperおよびRichで構築されたCLIがあり、CLIにはスラッシュコマンド、リアルタイムのTUIダッシュボード、一括クエリ機能が含まれます。会話は分岐グラフとして保存され、分岐の作成やチェックアウト、コンテキスト上限に収まるよう要約したり、JSON形式でインポート・エクスポートしたりできます。

サーバーの検出方法には、ローカルのスクリプトディレクトリ、Claude Desktop設定のインポート（WSLのパスに対応）、リモートレジストリ、ローカルネットワーク上のmDNS、オプションのポートスキャンがあります。ツールの実行結果はカテゴリごとのTTLと依存関係に基づく無効化を設定してディスクにキャッシュできます。また、OpenTelemetryのメトリクスとトレースにも標準で対応しています。

主な機能

  • 01stdio、SSE、streaming-HTTPトランスポート経由でMCPサーバーに接続。
  • 02リアルタイムのチャットストリーミング、サーバー管理、会話の分岐表示に対応したWeb UI。
  • 03スラッシュコマンド、Markdown表示、リアルタイムのTUIダッシュボードを備えた対話型CLI。
  • 04分岐の作成、チェックアウト、要約、インポート、エクスポートに対応する会話グラフ。
  • 05ローカルディレクトリ、Claude Desktopの設定、リモートレジストリ、mDNS、ポートスキャンを利用したサーバー検出。
  • 06TTLと依存関係に基づく無効化を備えたツール実行結果のキャッシュ。

ユースケース

  • 独自のクライアントを実装せずに、ClaudeでMCPツールを試す。
  • 生のJSON-RPCログやサーバーごとのstderrログを使って、ローカルのMCPサーバーをテスト・デバッグする。
  • Claudeをローカルおよびリモートのツールサーバーに接続する、セルフホスト型のチャットインターフェースを運用する。
  • 会話を分岐させて比較し、別の会話展開を試す。

クイックスタート

  1. 1

    uv をインストールする（README に記載されている公式インストールスクリプトを実行）

  2. 2

    リポジトリをクローンする

    git clone https://github.com/Dicklesworthstone/ultimate_mcp_client
  3. 3

    依存関係をインストールする（Python 3.13 以降が必要）

    uv sync --all-extras
  4. 4

    Web UI を起動する（先に ANTHROPIC_API_KEY を設定）

    mcpclient run --webui

使う前に知っておきたいこと

  • Python 3.13 以降が必要です。
  • Claude モデルを使用するには Anthropic API キーが必要です。
  • ライセンスは非標準（MIT に OpenAI/Anthropic 条項を追加）と記載されているため、商用利用の前に条件を確認してください。

トピック

#mcp#ai-agents#anthropic#claude#python#asyncio#cli#web-ui

よくある質問

ultimate_mcp_client とは？
stdio、SSE、streaming-HTTP経由でAIモデルとMCPサーバーを接続する、対話型CLIとWeb UIを備えた非同期Pythonクライアント。 Ultimate MCP Clientは、AIモデルが外部のツール、リソース、プロンプトにアクセスする方法を標準化するModel Context Protocol（MCP）用のPythonクライアントです。Anthropic SDKを通じてClaudeモデルを、ローカルのstdioプロセスとして動作するMCPサーバーや、リモートのSSEおよびstreaming-HTTPエンドポイントに接続し、各ツールを提供するサーバーにツール呼び出しを振り分けます。
ultimate_mcp_client は無料で使えますか？ライセンスは？
ultimate_mcp_client は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
ultimate_mcp_client は今もメンテナンスされていますか？
活発にメンテナンス中。ultimate_mcp_client の最終コミットは 2026年10月14日 です。
ultimate_mcp_client は何に使えますか？
独自のクライアントを実装せずに、ClaudeでMCPツールを試す。 生のJSON-RPCログやサーバーごとのstderrログを使って、ローカルのMCPサーバーをテスト・デバッグする。 Claudeをローカルおよびリモートのツールサーバーに接続する、セルフホスト型のチャットインターフェースを運用する。 会話を分岐させて比較し、別の会話展開を試す。
ultimate_mcp_client のインストール方法は？
uv をインストールする（README に記載されている公式インストールスクリプトを実行） リポジトリをクローンする: git clone https://github.com/Dicklesworthstone/ultimate_mcp_client 依存関係をインストールする（Python 3.13 以降が必要）: uv sync --all-extras Web UI を起動する（先に ANTHROPIC_API_KEY を設定）: mcpclient run --webui
ultimate_mcp_client はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/Dicklesworthstone/ultimate_mcp_client

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト