Repolode
Enviar
Dicklesworthstone

Dicklesworthstone/ultimate_mcp_client

Cliente assíncrono em Python para o Model Context Protocol, com CLI interativa e interface web para conectar modelos de IA a servidores MCP via stdio, SSE e streaming-HTTP.

Ver no GitHub
Estrelas
171
Forks
23
Issues abertas
0
Último commit
há 8 dias

O que é?

Ultimate MCP Client é um cliente Python para o Model Context Protocol (MCP), que padroniza como modelos de IA acessam ferramentas, recursos e prompts externos. Ele conecta modelos Claude a servidores MCP por meio do Anthropic SDK, seja como processos locais via stdio ou endpoints remotos via SSE e streaming-HTTP, e encaminha chamadas de ferramentas ao servidor que fornece cada ferramenta.

O projeto oferece duas interfaces sobre o mesmo núcleo: uma interface web feita com FastAPI, WebSockets, Alpine.js e DaisyUI, e uma CLI criada com Typer e Rich, que inclui comandos com barra, um painel TUI em tempo real e consultas em lote. As conversas são armazenadas como um grafo com ramificações, que pode ser bifurcado, retomado, resumido para caber nos limites de contexto e exportado ou importado como JSON.

A descoberta de servidores inclui diretórios de scripts locais, importação da configuração do Claude Desktop (com adaptação de caminhos do WSL), registros remotos, mDNS na rede local e varredura opcional de portas. Os resultados das ferramentas podem ser armazenados em cache no disco, com TTLs por categoria e invalidação baseada em dependências. Métricas e traces do OpenTelemetry já vêm integrados.

Recursos principais

  • 01Conecta-se a servidores MCP pelos transportes stdio, SSE e streaming-HTTP.
  • 02Interface web com streaming de chat em tempo real, gerenciamento de servidores e visualização das ramificações das conversas.
  • 03CLI interativa com comandos com barra, renderização de Markdown e painel TUI em tempo real.
  • 04Grafo de conversas com ramificações, incluindo bifurcação, retomada, resumo, importação e exportação.
  • 05Descobre servidores por diretórios locais, configuração do Claude Desktop, registros remotos, mDNS e varredura de portas.
  • 06Armazena resultados de ferramentas em cache com TTLs e invalidação baseada em dependências.

Casos de uso

  • Experimentar ferramentas MCP no Claude sem escrever um cliente personalizado.
  • Testar e depurar um servidor MCP local com logs JSON-RPC brutos e logs de stderr separados por servidor.
  • Executar uma interface de chat auto-hospedada que conecta o Claude a servidores de ferramentas locais e remotos.
  • Explorar caminhos alternativos de conversa bifurcando e comparando ramificações.

Início rápido

  1. 1

    Instale o uv (execute o script oficial de instalação indicado no README)

  2. 2

    Clone o repositório

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

    Instale as dependências (é necessário Python 3.13 ou superior)

    uv sync --all-extras
  4. 4

    Inicie a Web UI (configure ANTHROPIC_API_KEY antes)

    mcpclient run --webui

Antes de usar

  • É necessário Python 3.13 ou superior.
  • É necessária uma chave de API da Anthropic para usar modelos Claude.
  • A licença está listada como não padrão (MIT com uma cláusula adicional da OpenAI/Anthropic), então confira os termos antes de usar comercialmente.

Tópicos

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

Perguntas frequentes

O que é ultimate_mcp_client?
Cliente assíncrono em Python para o Model Context Protocol, com CLI interativa e interface web para conectar modelos de IA a servidores MCP via stdio, SSE e streaming-HTTP. Ultimate MCP Client é um cliente Python para o Model Context Protocol (MCP), que padroniza como modelos de IA acessam ferramentas, recursos e prompts externos. Ele conecta modelos Claude a servidores MCP por meio do Anthropic SDK, seja como processos locais via stdio ou endpoints remotos via SSE e streaming-HTTP, e encaminha chamadas de ferramentas ao servidor que fornece cada ferramenta.
ultimate_mcp_client é gratuito? Qual é a licença?
ultimate_mcp_client é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
ultimate_mcp_client ainda é mantido?
Manutenção ativa. O último commit de ultimate_mcp_client foi em 14 de out. de 2026.
Para que posso usar ultimate_mcp_client?
Experimentar ferramentas MCP no Claude sem escrever um cliente personalizado. Testar e depurar um servidor MCP local com logs JSON-RPC brutos e logs de stderr separados por servidor. Executar uma interface de chat auto-hospedada que conecta o Claude a servidores de ferramentas locais e remotos. Explorar caminhos alternativos de conversa bifurcando e comparando ramificações.
Como instalar ultimate_mcp_client?
Instale o uv (execute o script oficial de instalação indicado no README) Clone o repositório: git clone https://github.com/Dicklesworthstone/ultimate_mcp_client Instale as dependências (é necessário Python 3.13 ou superior): uv sync --all-extras Inicie a Web UI (configure ANTHROPIC_API_KEY antes): mcpclient run --webui
Onde consigo ultimate_mcp_client?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Dicklesworthstone/ultimate_mcp_client

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados