Skip to main content
Glama
agentrix-ai

Uno MCP Stdio

by agentrix-ai

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:

  1. Communicates with MCP clients using stdio mode (supported by all clients)

  2. Securely stores OAuth tokens locally

  3. 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-remote-py

πŸš€ 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

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/agentrix-ai/uno-mcp-stdio'

If you have feedback or need assistance with the MCP directory API, please join our Discord server