Repolode
Enviar
Dicklesworthstone

Dicklesworthstone/ultimate_mcp_client

Cliente asíncrono en Python para el Model Context Protocol, con una CLI interactiva y una interfaz web para conectar modelos de IA a servidores MCP mediante stdio, SSE y streaming-HTTP.

Ver en GitHub
Estrellas
171
Forks
23
Issues abiertos
0
Último commit
hace 8 días

¿Qué es?

Ultimate MCP Client es un cliente de Python para Model Context Protocol (MCP), que estandariza la forma en que los modelos de IA acceden a herramientas, recursos y prompts externos. Conecta modelos de Claude mediante Anthropic SDK a servidores MCP que se ejecutan como procesos locales por stdio o en endpoints remotos SSE y streaming-HTTP, y dirige cada llamada a la herramienta al servidor que la proporciona.

El proyecto ofrece dos interfaces sobre el mismo núcleo: una interfaz web creada con FastAPI, WebSockets, Alpine.js y DaisyUI, y una CLI creada con Typer y Rich que incluye comandos con barra diagonal, un panel TUI en vivo y consultas por lotes. Las conversaciones se guardan como un grafo ramificado que se puede bifurcar, seleccionar, resumir para ajustarse a los límites de contexto y exportar o importar en JSON.

La detección de servidores abarca directorios de scripts locales, la importación de la configuración de Claude Desktop (con adaptación de rutas de WSL), registros remotos, mDNS en la red local y el escaneo opcional de puertos. Los resultados de las herramientas se pueden almacenar en caché en disco con TTL por categoría e invalidación basada en dependencias; además, incluye métricas y trazas de OpenTelemetry.

Funciones clave

  • 01Se conecta a servidores MCP mediante transportes stdio, SSE y streaming-HTTP.
  • 02Interfaz web con transmisión del chat en tiempo real, administración de servidores y visualización de las ramas de conversación.
  • 03CLI interactiva con comandos con barra diagonal, renderizado de Markdown y un panel TUI en vivo.
  • 04Grafo de conversación ramificado con funciones para bifurcar, seleccionar, resumir, importar y exportar.
  • 05Detecta servidores mediante directorios locales, la configuración de Claude Desktop, registros remotos, mDNS y escaneo de puertos.
  • 06Almacena en caché los resultados de las herramientas con TTL e invalidación basada en dependencias.

Casos de uso

  • Probar herramientas MCP en Claude sin escribir un cliente personalizado.
  • Probar y depurar un servidor MCP local con registros JSON-RPC sin procesar y registros stderr por servidor.
  • Ejecutar una interfaz de chat autoalojada que conecta Claude con servidores de herramientas locales y remotos.
  • Explorar rutas de conversación alternativas mediante la bifurcación y comparación de ramas.

Inicio rápido

  1. 1

    Instala uv (ejecuta el script de instalación oficial indicado en el README)

  2. 2

    Clona el repositorio

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

    Instala las dependencias (se requiere Python 3.13 o posterior)

    uv sync --all-extras
  4. 4

    Inicia la Web UI (configura ANTHROPIC_API_KEY primero)

    mcpclient run --webui

Antes de usarlo

  • Se requiere Python 3.13 o posterior.
  • Se necesita una clave de API de Anthropic para usar modelos Claude.
  • La licencia figura como no estándar (MIT con una cláusula adicional de OpenAI/Anthropic), así que revisa sus términos antes de usarla con fines comerciales.

Temas

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

Preguntas frecuentes

¿Qué es ultimate_mcp_client?
Cliente asíncrono en Python para el Model Context Protocol, con una CLI interactiva y una interfaz web para conectar modelos de IA a servidores MCP mediante stdio, SSE y streaming-HTTP. Ultimate MCP Client es un cliente de Python para Model Context Protocol (MCP), que estandariza la forma en que los modelos de IA acceden a herramientas, recursos y prompts externos. Conecta modelos de Claude mediante Anthropic SDK a servidores MCP que se ejecutan como procesos locales por stdio o en endpoints remotos SSE y streaming-HTTP, y dirige cada llamada a la herramienta al servidor que la proporciona.
¿ultimate_mcp_client es gratuito? ¿Qué licencia tiene?
ultimate_mcp_client es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ultimate_mcp_client sigue mantenido?
Mantenimiento activo. El último commit de ultimate_mcp_client fue el 14 oct 2026.
¿Para qué puedo usar ultimate_mcp_client?
Probar herramientas MCP en Claude sin escribir un cliente personalizado. Probar y depurar un servidor MCP local con registros JSON-RPC sin procesar y registros stderr por servidor. Ejecutar una interfaz de chat autoalojada que conecta Claude con servidores de herramientas locales y remotos. Explorar rutas de conversación alternativas mediante la bifurcación y comparación de ramas.
¿Cómo se instala ultimate_mcp_client?
Instala uv (ejecuta el script de instalación oficial indicado en el README) Clona el repositorio: git clone https://github.com/Dicklesworthstone/ultimate_mcp_client Instala las dependencias (se requiere Python 3.13 o posterior): uv sync --all-extras Inicia la Web UI (configura ANTHROPIC_API_KEY primero): mcpclient run --webui
¿Dónde consigo ultimate_mcp_client?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Dicklesworthstone/ultimate_mcp_client

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados