TUUI - Tool Unitary User Interface

by ai-ql

Not rated
GitHub

About

A desktop MCP client for tool integration and cross-vendor LLM API orchestration.

Details

Author
ai-ql
Categories
Developer Tools, AI, Other

Setup

Install TUUI - Tool Unitary User Interface in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/ai-ql/tuui

Follow the installation instructions in the repository README, then restart your MCP client.

A desktop MCP client for tool integration and cross-vendor LLM API orchestration.

TUUI is a desktop MCP client designed as a tool unitary utility integration, accelerating AI adoption through the Model Context Protocol (MCP) and enabling cross-vendor LLM API orchestration.

Zero accountsFull controlOpen sourceDownload and Run

This repository is essentially anLLM chat desktop application based on MCP. It also represents a bold experiment increating a complete project using AI. Many components within the project have been directly converted or generated from the prototype project through AI.

Given the considerations regarding the quality and safety of AI-generated content, this project employs strict syntax checks and naming conventions. Therefore, for any further development, please ensure that you use the linting tools I've set up to check and automatically fix syntax issues.

- ✨ Accelerate AI tool integration via MCP
- ✨ Orchestrate cross-vendor LLM APIs through dynamic configuring
- ✨ Automated application testing Support
- ✨ TypeScript support
- ✨ Multilingual support
- ✨ Basic layout manager
- ✨ Global state management through the Pinia store
- ✨ Quick support through the GitHub community and official documentation

You can quickly get started with the project through a variety of options tailored to your role and needs:

-

Toexplorethe project, visit the wiki page:TUUI.com

Todownloadand use the application directly, go to the releases page:Releases

Fordevelopersetup, refer to the installation guide:Getting Started (English)|快速入门 (中文)

Toask the AIdirectly about the project, visit:TUUI@DeepWiki

To use MCP-related features, ensure the following preconditions are met for your environment:

-

Set up an LLM backend (e.g.,ChatGPT,Claude,Qwenor self-hosted) that supports tool/function calling.

For NPX/NODE-based servers: InstallNode.jsto execute JavaScript/TypeScript tools.

For UV/UVX-based servers: InstallPythonand theUVlibrary.

For Docker-based servers: InstallDockerHub.

For macOS/Linux systems: Modify the default MCP configuration (e.g., adjust CLI paths or permissions).

Refer to theMCP Server Issuedocumentation for guidance

For guidance on configuring the LLM, refer to the template(i.e.: 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 }

The configuration accepts either a JSON object (for a single chatbot) or a JSON array (for multiple 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 } ]

For the decomposable package, you can also modify the default configuration of the built release:

For example,src/main/assets/config/llm.jsonwill be located inresources/assets/config/llm.json

Once you modify or import the configurations, it will be stored in yourlocalStorageby default.

Alternatively, you can clear all configurations from theTray Menuby selectingClear Storage.

You can utilize Cloudflare's recommendedmcp-remoteto implement the full suite of remote MCP server functionalities (including Auth). For example, simply add the following to yourmcp.jsonfile:

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

In this example, I have provided a test remote server:https://YOURDOMAIN.comonCloudflare. This server will always approve your authentication requests.

If you encounter any issues (please try to maintain OAuth auto-redirect to prevent callback delays that might cause failures), such as the common HTTP 400 error. You can resolve them by clearing your browser cache on the authentication page and then attempting verification again:

When launching the MCP server, if you encounter any issues, first ensure that the corresponding command can run on your current system — for example,uv/uvx,npx, etc.

When launching the MCP server, if you encounter spawn errors likeENOENT, try running the corresponding MCP server locally and invoking it using an absolute path.

If the command works but MCP initialization still returns spawn errors, this may be a known issue:

-

Windows: The MCP SDK includes a workaround specifically forWindowssystems, as documented inISSUE 101.

Details:ISSUE 40 - MCP servers fail to connect with npx on Windows(fixed)

mscOS: The issue remains unresolved on other platforms, specificallymacOS. Although several workarounds are available, this ticket consolidates the most effective ones and highlights the simplest method:How to configure MCP on macOS.

Details:ISSUE 64 - MCP Servers Don't Work with NVM(still open)

If initialization takes too long and triggers the 90-second timeout protection, it may be because theuv/uvx/npxruntime libraries are being installed or updated for the first time.

When your connection to the respectivepipornpmrepository is slow, installation can take a long time.

In such cases, first complete the installation manually withpipornpmin the relevant directory, and then start the MCP server again.

We welcome contributions of any kind to this project, including feature enhancements, UI improvements, documentation updates, test case completions, and syntax corrections. I believe that a real developer can write better code than AI, so if you have concerns about certain parts of the code implementation, feel free to share your suggestions or submit a pull request.

Please review ourCode of Conduct. It is in effect at all times. We expect it to be honored by everyone who contributes to this project.

For more information, please seeContributing Guidelines

Before creating an issue, check if you are using the latest version of the project. If you are not up-to-date, see if updating fixes your issue first.

Review ourSecurity Policy. Do not file a public issue for security vulnerabilities.

Many of the ideas and prose for the statements in this project were based on or inspired by work from the following communities:

You can review the specific technical details and the license. We commend them for their efforts to facilitate collaboration in their projects.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

next-devtools-mcp is a MCP server that provides Next.js development tools and utilities for AI coding assistants like Claude and Cursor.

Word search, crossword, and sudoku generator MCP server with printable PDF worksheets, themed word banks, and verifiable LLM evals. Local-first, from the makers of puzzletide.com.

A demonstration server for ActionKit, providing access to Slack actions via Claude Desktop.

MCP server that lets Claude Code agents delegate tasks to agents in other project directories, with parallel dispatch, sessions, and async jobs.

Statistical regression testing for LLM agents: p-value, effect size, and CI on behavior change.

A Python MCP package that gives your LLM agents complete file system and shell capabilities — production-ready, sandboxed, and wired to any LLM in minutes.

Integrates with Google AI Studio/Gemini API for PDF to Markdown conversion and content generation.

Anchor Browser (https://anchorbrowser.io) is secure infrastructure for computer-use agents — stealth cloud browsers, authentication, captcha bypass, and a hosted MCP server for Cursor, Claude, and Windsurf.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.