TUUI - Tool Unitary User Interface

Um cliente MCP desktop para integração de ferramentas e orquestração de API LLM entre fornecedores.

GitHub

1.2k

Experimente este MCPPatrocinado

Documentação

TUUI - Playground de IA Local com MCP

TUUI é um cliente MCP desktop projetado como uma integração utilitária unitária de ferramentas, acelerando a adoção de IA através do Model Context Protocol (MCP) e permitindo orquestração de APIs LLM de múltiplos fornecedores.

`Zero accounts` `Full control` `Open source` `Download and Run`

📜 Introdução

Este repositório é essencialmente um aplicativo desktop de chat LLM baseado em MCP. Ele também representa um experimento ousado em criar um projeto completo usando IA. Muitos componentes dentro do projeto foram diretamente convertidos ou gerados a partir do projeto protótipo através de IA.

Considerando as preocupações sobre a qualidade e segurança do conteúdo gerado por IA, este projeto emprega verificações rigorosas de sintaxe e convenções de nomenclatura. Portanto, para qualquer desenvolvimento adicional, certifique-se de usar as ferramentas de linting que configurei para verificar e corrigir automaticamente problemas de sintaxe.

✨ Destaques

✨ Acelere a integração de ferramentas de IA via MCP
✨ Orquestre APIs LLM de múltiplos fornecedores através de configuração dinâmica
✨ Suporte a testes automatizados de aplicativos
✨ Suporte a TypeScript
✨ Suporte multilíngue
✨ Gerenciador de layout básico
✨ Gerenciamento de estado global através do store Pinia
✨ Suporte rápido através da comunidade GitHub e documentação oficial

🔥 Recursos MCP

Status	Recurso	Categoria	Nota
✅	Tools	Servidor
✅	Prompts	Servidor
✅	Resources	Servidor
🔲	Roots	Cliente	Isso geralmente é usado apenas para o IDE Vibe Coding e normalmente pode ser configurado através de variáveis de ambiente do servidor.
✅	Sampling	Cliente
✅	Elicitation	Cliente
✅	Discovery	Registro	Fornece descoberta de servidores MCP em tempo real no registro MCP
✅	MCPB	Extensão	MCP Bundles (.mcpb) é o novo nome para o que anteriormente era conhecido como Desktop Extensions (.dxt)

🚀 Começando

Você pode começar rapidamente com o projeto através de uma variedade de opções adaptadas ao seu papel e necessidades:

Para explore o projeto, visite a página wiki: TUUI.com
Para download e usar o aplicativo diretamente, vá para a página de releases: Releases
Para developer de configuração, consulte o guia de instalação: Getting Started (English) | 快速入门 (中文)
Para ask the AI diretamente sobre o projeto, visite: TUUI@DeepWiki

⚙️ Requisitos Principais

Para usar recursos relacionados ao MCP, garanta que os seguintes pré-requisitos sejam atendidos no seu ambiente:

Configure um backend LLM (ex.: ChatGPT, Claude, Qwen ou auto-hospedado) que suporte chamadas de ferramentas/funções.
Para servidores baseados em NPX/NODE: Instale Node.js para executar ferramentas JavaScript/TypeScript.
Para servidores baseados em UV/UVX: Instale Python e a biblioteca UV.
Para servidores baseados em Docker: Instale DockerHub.
Para sistemas macOS/Linux: Modifique a configuração padrão do MCP (ex.: ajuste caminhos de CLI ou permissões).

Consulte a documentação MCP Server Issue para orientação

Para orientação sobre como configurar o LLM, consulte o modelo (ex.: Qwen):

{
  "name": "Qwen",
  "apiKey": "",
  "url": "https://dashscope.aliyuncs.com/compatible-mode",
  "path": "/v1/chat/completions",
  "model": "qwen-turbo",
  "modelList": ["qwen-turbo", "qwen-plus", "qwen-max"],
  "maxTokensValue": "",
  "mcp": true
}

A configuração aceita um objeto JSON (para um único chatbot) ou um array JSON (para múltiplos chatbots):

[
  {
    "name": "Openrouter && Proxy",
    "apiKey": "",
    "url": "https://api3.aiql.com",
    "urlList": ["https://api3.aiql.com", "https://openrouter.ai/api"],
    "path": "/v1/chat/completions",
    "model": "openai/gpt-4.1-mini",
    "modelList": [
      "openai/gpt-4.1-mini",
      "openai/gpt-4.1",
      "anthropic/claude-sonnet-4",
      "google/gemini-2.5-pro-preview"
    ],
    "maxTokensValue": "",
    "mcp": true
  },
  {
    "name": "DeepInfra",
    "apiKey": "",
    "url": "https://api.deepinfra.com",
    "path": "/v1/openai/chat/completions",
    "model": "Qwen/Qwen3-32B",
    "modelList": [
      "Qwen/Qwen3-32B",
      "Qwen/Qwen3-235B-A22B",
      "meta-llama/Meta-Llama-3.1-70B-Instruct"
    ],
    "mcp": true
  }
]

📕 Configuração Adicional

Configuração	Descrição	Localização	Nota
Endpoints LLM	Config padrão de Chatbots LLM	llm.json	Tipos completos de configuração podem ser encontrados em llm.d.ts
Servidores MCP	Configs padrão de servidores MCP	mcp.json	Para sintaxe de configuração, veja MCP Servers
Tela Inicial	Notícias padrão na Tela Inicial	startup.json
Tela Popup	Prompts padrão na Tela Inicial	popup.json

Para o pacote decomponível, você também pode modificar a configuração padrão da versão compilada:

Por exemplo, src/main/assets/config/llm.json estará localizado em resources/assets/config/llm.json

Depois de modificar ou importar as configurações, elas serão armazenadas no seu localStorage por padrão.

Alternativamente, você pode limpar todas as configurações do Tray Menu selecionando Clear Storage.

🌐 Servidor MCP Remoto

Você pode utilizar o mcp-remote recomendado pela Cloudflare para implementar o conjunto completo de funcionalidades de servidor MCP remoto (incluindo Auth). Por exemplo, basta adicionar o seguinte ao seu arquivo mcp.json:

{
  "mcpServers": {
    "cloudflare": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOURDOMAIN.com/sse"]
    }
  }
}

Neste exemplo, forneci um servidor remoto de teste: https://YOURDOMAIN.com no Cloudflare. Este servidor sempre aprovará suas solicitações de autenticação.

Se você encontrar quaisquer problemas (tente manter o redirecionamento automático de OAuth para evitar atrasos de callback que possam causar falhas), como o erro comum HTTP 400. Você pode resolvê-los limpando o cache do navegador na página de autenticação e tentando a verificação novamente:

🚸 Problemas com Servidor MCP

Geral

Ao iniciar o servidor MCP, se você encontrar quaisquer problemas, primeiro garanta que o comando correspondente possa ser executado no seu sistema atual — por exemplo, uv/uvx, npx, etc.

Erros ENOENT Spawn

Ao iniciar o servidor MCP, se você encontrar erros de spawn como ENOENT, tente executar o servidor MCP correspondente localmente e invocá-lo usando um caminho absoluto.

Se o comando funcionar, mas a inicialização do MCP ainda retornar erros de spawn, isso pode ser um problema conhecido:

Windows: O SDK MCP inclui uma solução alternativa especificamente para sistemas Windows, conforme documentado em ISSUE 101.

Detalhes: ISSUE 40 - MCP servers fail to connect with npx on Windows (corrigido)
macOS: O problema permanece sem solução em outras plataformas, especificamente macOS. Embora várias soluções alternativas estejam disponíveis, este ticket consolida as mais eficazes e destaca o método mais simples: How to configure MCP on macOS.

Detalhes: ISSUE 64 - MCP Servers Don't Work with NVM (ainda aberto)

Timeout de Conexão MCP

Se a inicialização demorar muito e acionar a proteção de timeout de 90 segundos, pode ser porque as bibliotecas de runtime uv/uvx/npx estão sendo instaladas ou atualizadas pela primeira vez.

Quando sua conexão com o respectivo repositório pip ou npm estiver lenta, a instalação pode demorar muito tempo.

Nesses casos, primeiro complete a instalação manualmente com pip ou npm no diretório relevante, e então inicie o servidor MCP novamente.

🤝 Contribuindo

Aceitamos contribuições de qualquer tipo para este projeto, incluindo melhorias de recursos, melhorias de UI, atualizações de documentação, conclusão de casos de teste e correções de sintaxe. Acredito que um desenvolvedor real pode escrever código melhor que IA, então se você tiver preocupações sobre certas partes da implementação do código, sinta-se à vontade para compartilhar suas sugestões ou enviar um pull request.

Por favor, revise nosso Code of Conduct. Ele está em vigor em todos os momentos. Esperamos que seja respeitado por todos que contribuem para este projeto.

Para mais informações, veja Contributing Guidelines

🙋 Abrindo uma Issue

Antes de criar uma issue, verifique se você está usando a versão mais recente do projeto. Se você não estiver atualizado, veja se atualizar resolve seu problema primeiro.