Repolode
Submit
Dicklesworthstone

Dicklesworthstone/ultimate_mcp_client

Async Python client for the Model Context Protocol, with an interactive CLI and a web UI for connecting AI models to MCP servers over stdio, SSE and streaming-HTTP.

View on GitHub
Stars
171
Forks
23
Open issues
0
Last commit
8 days ago

What is it?

Ultimate MCP Client is a Python client for the Model Context Protocol (MCP), which standardizes how AI models access external tools, resources and prompts. It connects Claude models through the Anthropic SDK to MCP servers running as local stdio processes or remote SSE and streaming-HTTP endpoints, and routes tool calls to the server that provides each tool.

The project offers two front ends over the same core: a web UI built with FastAPI, WebSockets, Alpine.js and DaisyUI, and a CLI built with Typer and Rich that includes slash commands, a live TUI dashboard and batch queries. Conversations are stored as a branching graph that can be forked, checked out, summarized to fit context limits, and exported to or imported from JSON.

Server discovery covers local script directories, Claude Desktop configuration import (with WSL path adaptation), remote registries, mDNS on the local network and optional port scanning. Tool results can be cached on disk with per-category TTLs and dependency-based invalidation, and OpenTelemetry metrics and traces are built in.

Key features

  • 01Connects to MCP servers over stdio, SSE and streaming-HTTP transports.
  • 02Web UI with real-time chat streaming, server management and conversation branch visualization.
  • 03Interactive CLI with slash commands, Markdown rendering and a live TUI dashboard.
  • 04Branching conversation graph with fork, checkout, summarization, import and export.
  • 05Discovers servers via local directories, Claude Desktop config, remote registries, mDNS and port scanning.
  • 06Caches tool results with TTLs and dependency-based invalidation.

Use cases

  • Experimenting with MCP tools in Claude without writing a custom client.
  • Testing and debugging a local MCP server with raw JSON-RPC logging and per-server stderr logs.
  • Running a self-hosted chat interface that connects Claude to local and remote tool servers.
  • Exploring alternative conversation paths by forking and comparing branches.

Quick start

  1. 1

    Install uv (run the official install script from the README)

  2. 2

    Clone the repository

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

    Install dependencies (Python 3.13+ required)

    uv sync --all-extras
  4. 4

    Launch the Web UI (set ANTHROPIC_API_KEY first)

    mcpclient run --webui

Things to know

  • Requires Python 3.13 or newer.
  • Needs an Anthropic API key to use Claude models.
  • The license is listed as non-standard (MIT with an OpenAI/Anthropic rider), so check its terms before commercial use.

Topics

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

FAQ

What is ultimate_mcp_client?
Async Python client for the Model Context Protocol, with an interactive CLI and a web UI for connecting AI models to MCP servers over stdio, SSE and streaming-HTTP. Ultimate MCP Client is a Python client for the Model Context Protocol (MCP), which standardizes how AI models access external tools, resources and prompts. It connects Claude models through the Anthropic SDK to MCP servers running as local stdio processes or remote SSE and streaming-HTTP endpoints, and routes tool calls to the server that provides each tool.
Is ultimate_mcp_client free to use? What license does it have?
ultimate_mcp_client is open source under the Other license. Check the license terms before using it in commercial products.
Is ultimate_mcp_client still maintained?
Actively maintained. The last commit to ultimate_mcp_client was on Oct 14, 2026.
What can I use ultimate_mcp_client for?
Experimenting with MCP tools in Claude without writing a custom client. Testing and debugging a local MCP server with raw JSON-RPC logging and per-server stderr logs. Running a self-hosted chat interface that connects Claude to local and remote tool servers. Exploring alternative conversation paths by forking and comparing branches.
How do I install ultimate_mcp_client?
Install uv (run the official install script from the README) Clone the repository: git clone https://github.com/Dicklesworthstone/ultimate_mcp_client Install dependencies (Python 3.13+ required): uv sync --all-extras Launch the Web UI (set ANTHROPIC_API_KEY first): mcpclient run --webui
Where can I get ultimate_mcp_client?
The source code and installation instructions are on GitHub: https://github.com/Dicklesworthstone/ultimate_mcp_client

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects