How do I use Uno MCP Stdio?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Uno MCP Stdio start the proxy" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Uno MCP Stdio

by agentrix-ai

Overview Schema Source Related Servers Discussions Admin

Python

Local

Uno MCP Stdio

PyPI version Python 3.11+ License: MIT

Local stdio proxy for Uno MCP Gateway - Provides local proxy for MCP clients that don't support OAuth authentication.

🎯 Problem Solved

Many MCP clients (such as Manus, Cherry Studio) don't support OAuth 2.0 authentication and cannot directly connect to MCP servers that require authentication.

uno-mcp-stdio acts as a local proxy:

Communicates with MCP clients using stdio mode (supported by all clients)
Securely stores OAuth tokens locally
Proxies requests to remote Uno Gateway, automatically attaching authentication information

┌─────────────────┐     stdio      ┌─────────────────┐     HTTPS      ┌─────────────────┐
│   MCP Client    │ ◄────────────► │  uno-mcp-stdio  │ ◄────────────► │  Uno Gateway    │
│ (No OAuth)      │                │  (Local Proxy)  │   + Bearer     │  (Remote)       │
└─────────────────┘                └─────────────────┘                └─────────────────┘

Related MCP server: mcp-client-credentials-auth

🚀 Quick Start

Installation

# Run directly with uvx (recommended)
uvx uno-mcp-stdio

# Or install with pip
pip install uno-mcp-stdio
uno-mcp-stdio

First Run

OAuth authentication is required on first run:

$ uvx uno-mcp-stdio
🔐 Authentication required
📋 Please open the following link in your browser to complete authentication:
   https://mcpmarket.cn/oauth/authorize?...

⏳ Waiting for authentication...
✅ Authentication successful! Token saved
🚀 Uno MCP Stdio is ready

Configure MCP Client

Configure stdio server in your MCP client:

Manus / Cherry Studio Configuration Example:

{
  "mcpServers": {
    "uno": {
      "command": "uvx",
      "args": ["uno-mcp-stdio"]
    }
  }
}

If installed with pip:

{
  "mcpServers": {
    "uno": {
      "command": "uno-mcp-stdio"
    }
  }
}

⚙️ Configuration

Environment Variables

Variable	Description	Default
`UNO_GATEWAY_URL`	Uno Gateway URL	`https://uno.mcpmarket.cn/mcp`
`UNO_CREDENTIALS_PATH`	Token storage path	`~/.uno-mcp/credentials.json`
`UNO_DEBUG`	Debug mode	`false`

Token Storage

Authenticated tokens are stored in ~/.uno-mcp/credentials.json:

{
  "access_token": "xxx",
  "refresh_token": "xxx",
  "expires_at": 1736345678,
  "token_type": "Bearer"
}

Clear Authentication

# Delete token file to re-authenticate
rm ~/.uno-mcp/credentials.json

🔐 Authentication Flow

1. Start uno-mcp-stdio
   │
   ▼
2. Check ~/.uno-mcp/credentials.json
   │
   ├─ Valid token → Proxy requests directly
   │
   └─ No/expired token → Start authentication flow
      │
      ▼
3. Start temporary HTTP server (localhost:random port)
   │
   ▼
4. Generate OAuth URL, display to user
   │
   ▼
5. User completes authorization in browser
   │
   ▼
6. MCPMarket callback to local server
   │
   ▼
7. Exchange token, save to file
   │
   ▼
8. Close temporary server, start proxying

🛠️ Development

# Clone repository
git clone https://github.com/agentrix-ai/uno-mcp-stdio.git
cd uno-mcp-stdio

# Install dependencies
uv sync

# Run
uv run uno-mcp-stdio

# Debug mode
UNO_DEBUG=true uv run uno-mcp-stdio

📄 License

MIT

🌐 Languages

English (current)
中文

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

OneDroid SynapseOAuth
ai.onedroid
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Security Observability
1
MANDATE Credential Broker B
io.github.projetnanocorp
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Security
111
mcphost B
dev.mcphost
Host your MCP tool over streamable HTTP in one command.
Autonomous Agents Developer Tools
681
Sensact
io.github.sensact-agents
An authenticated remote MCP server for user-owned devices and one-shot capability invocation.
OS Automation App Automation
2

Related MCP Servers

mcp-streaming-http-proxy
Developer Tools Agent Orchestration
hahooh
A
license
Not graded
quality
D
maintenance
Proxies STDIO-based MCP clients to streaming HTTP MCP servers, enabling local clients to connect to remote servers.
Updated a year ago (2025-10-31 14:01 UTC)
9 npm
3
MIT
mcp-client-credentials-auth
Security Developer Tools Autonomous Agents
redhat-community-ai-tools
A
license
Not graded
quality
A
maintenance
A local stdio MCP server that authenticates to remote OAuth-protected MCP servers using the client_credentials grant, handling token acquisition and request forwarding.
Updated 6 days ago (2026-09-10 00:23 UTC)
25 npm
2
Apache 2.0
voris-mcp
Developer Tools
Rocket-Venture-Labs
A
license
Not graded
quality
B
maintenance
A thin stdio-to-HTTPS proxy that connects local MCP clients to the hosted Voris MCP server, forwarding JSON-RPC messages verbatim.
Updated 2 months ago (2026-07-15 08:43 UTC)
39 npm
MIT
eDocs AAuth Codex plugin
Security Autonomous Agents
kyle-macmillan
F
license
Not graded
quality
B
maintenance
Provides a local stdio MCP server proxy enabling Codex to interact with a remote AAuth-protected eDocs Streamable HTTP MCP server, handling authentication, consent elicitation, and token exchange.
Updated 9 days ago (2026-09-06 15:54 UTC)
-

Uno MCP Stdio

🎯 Problem Solved

🚀 Quick Start

Installation

First Run

Configure MCP Client

⚙️ Configuration

Environment Variables

Token Storage

Clear Authentication

🔐 Authentication Flow

🛠️ Development

📄 License

🌐 Languages

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp-streaming-http-proxy

mcp-client-credentials-auth

voris-mcp

eDocs AAuth Codex plugin