Skip to main content
Glama
Uno MCP Stdio

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-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

Available Tools

8 tools
uno_authA

🔐 认证管理工具。当前状态:❌ 未登录。请调用此工具完成认证后才能使用其他工具。支持的操作:login(登录)、status(查看状态)

Inputs: action.

uno_call_toolA

执行 MCP Server 上的具体工具。

【tool_name 格式】 "server_name.tool_name",例如:

  • amap-maps.maps_weather

  • time.get_current_time

  • github.search_repositories

【自动连接】

  • 普通 server:自动创建连接并执行

  • OAuth server:返回 auth_required + auth_url,用户在浏览器完成授权后重试

【典型流程】 uno_search_tools(query="天气") → 拿到 tools → uno_call_tool(tool_name="amap-maps.maps_weather", arguments={...})

【评分】调用成功后会返回 rating_hint,请调用 uno_rate_server 评分(0-5),帮助优化搜索排名。

Inputs: arguments (required), tool_name (required).

uno_connect_serverA

连接指定 MCP Server,处理 OAuth 授权。

【使用场景】

  • uno_search_servers 返回的 uncached server 需要认证时

  • 已知 server 名称,想获取其完整 tools 定义时

【返回内容】

  • 已连接/普通 server:返回该 server 全部 tools + inputSchema

  • OAuth server(未授权):返回 auth_url,用户点击完成授权后重新调用

【OAuth 流程】

  1. uno_connect_server(server_name="github") → 返回 auth_url

  2. 用户点击链接完成授权

  3. 再次调用 uno_connect_server(server_name="github") → 返回 tools

  4. 使用 uno_call_tool 调用具体工具

Inputs: server_name (required).

uno_get_creditsA

查询工具调用积分余额。返回当前积分、每日免费额度、已消耗总量和充值链接。积分不足时可引导用户通过 recharge_url 充值。

Inputs: no named parameters.

uno_rate_serverA

使用 tool 或 skill 后打分反馈。评分影响搜索推荐排名。

  • 对 tool 评分:传 tool_name(如 amap-maps.maps_weather)

  • 对 skill 评分:传 skill_id 调用成功后如果结果满意给高分(4-5),不满意给低分(1-2)。 收到 rating_hint 时请主动评分。

Inputs: rating (required), comment, skill_id, tool_name, +1 more.

uno_search_toolsA

搜索 MCP 工具。直接返回最相关的 tools 及完整参数定义,可立即调用 uno_call_tool。

【可用资源】共 144 个 MCP Server,使用 query 搜索。

【用法】

  1. 关键词搜索:uno_search_tools(query="天气")

  2. 语义搜索:uno_search_tools(query="帮我查北京天气", mode="hybrid")

  3. 分类浏览:uno_search_tools(category="金融")

【返回内容】

  • tools: 最相关的工具列表,每个包含 tool、desc、inputSchema,以及统计(rating/avg_ms/calls_7d/success_rate)

  • uncached: 需要先认证的 OAuth server(如有),调用 uno_connect_server 触发认证

  • 统计字段帮你选择更可靠的工具:calls_7d 高 = 热门,rating 高 = 好评,avg_ms 低 = 快

【工作流】 uno_search_tools(query="天气") → 拿到 tools → 立即 uno_call_tool(tool_name="amap-maps.maps_weather", ...)

Inputs: query (required), mode, limit, category.

uno_skills_fetchA

批量获取 skills 的完整内容。通常在 uno_skills_search 后使用。

返回每个 skill 的:

  • skill_md: SKILL.md 完整内容(Agent 使用指南)

  • files: 该 skill 目录下的文件清单

  • download_url: 整个 skill 包的 ZIP 下载链接

  • repo_url: GitHub 仓库链接

如果 skill 包含可执行脚本,可通过 download_url 下载整个包。

Inputs: skill_ids (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a clearly distinct purpose: authentication, credits, tool search, tool execution, server connection, rating, skill search, and skill fetch. The only shared verb 'search' is split cleanly between tools and skills, with no overlap in scope or return types.

    Naming Consistency4/5

    All tools use the same 'uno_' prefix and snake_case, with most following a verb_noun pattern (e.g., uno_search_tools, uno_call_tool). The outlier is uno_auth, which uses a noun instead of a verb, but it remains readable and consistent in prefix style.

    Tool Count5/5

    Eight tools is well-scoped for a meta-MCP aggregator, covering discovery, execution, authentication, feedback, and skill management without redundancy. Each tool earns its place in the workflow.

    Completeness3/5

    The set covers core operations but has notable gaps: the description for uno_connect_server references an 'uno_search_servers' tool that is not present, and uno_auth lacks a logout operation. These omissions could cause agent confusion or dead ends.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers