Uno MCP Stdio
This server is a gateway that lets you authenticate, discover, and call tools/skills across 144+ remote MCP servers through a single stdio proxy.
Authenticate (
uno_auth): login, logout, or check auth status; login is required before using other tools.Search tools (
uno_search_tools): find relevant MCP tools by keyword, semantic, or hybrid search, or browse by category; returns full parameter schemas plus reliability stats (rating, calls_7d, avg_ms, success_rate).Call tools (
uno_call_tool): execute any discovered tool viaserver_name.tool_namewith arguments, auto-connecting to the server (OAuth servers return an auth URL when needed).Connect servers (
uno_connect_server): connect to a specific MCP server by name, handle OAuth authorization, and retrieve its complete tool definitions.Rate servers/tools/skills (
uno_rate_server): submit a 0–5 score with optional comment to influence search ranking.Check credits (
uno_get_credits): view current credit balance, daily free quota, total consumed, and a recharge link.Search skills (
uno_skills_search): semantically search thousands of Cursor Agent Skills, returning skill IDs, descriptions, categories, stars/forks, and token cost.Fetch skills (
uno_skills_fetch): retrieve full SKILL.md content, file listings, ZIP download URLs, and repo links for up to 10 skills at a time.
Allows connecting to a GitHub MCP server through the Uno Gateway and calling its tools, such as searching repositories.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
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
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-stdioFirst 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 readyConfigure 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 |
|
| Token storage path |
|
| Debug mode |
|
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 toolsuno_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 流程】
uno_connect_server(server_name="github") → 返回 auth_url
用户点击链接完成授权
再次调用 uno_connect_server(server_name="github") → 返回 tools
使用 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 搜索。
【用法】
关键词搜索:uno_search_tools(query="天气")
语义搜索:uno_search_tools(query="帮我查北京天气", mode="hybrid")
分类浏览: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).
uno_skills_searchA
从数千个 Cursor Agent Skills 中语义搜索最相关的 skills。 返回 skill 的 meta 信息 + 质量信号,供选择参考。 使用场景:当你需要一个「能力/指南/工作流」而不是单个工具时。 搜索后可用 uno_skills_fetch 获取选中 skill 的完整 SKILL.md 内容。
返回字段说明:
skill_id: 唯一标识,用于 uno_skills_fetch
skill_name: 名称
description: 描述(可能含 en/zh)
categories: 分类标签
stars: GitHub stars(流行度)
forks: 被 fork 次数(流行度)
token_count: SKILL.md 的 token 数(加载成本参考)
Inputs: query (required), limit, category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Toolstile is a managed MCP gateway that connects remote MCP servers behind one endpoint, with per-agent permissions, shared accounts and activity logs. Connect at https://mcp.toolstile.com/mcp over Streamable HTTP with OAuth; sign in at https://toolstile.com, select a workspace and connect your upstream servers. Available tools, resources and prompts depend on that workspace and the agent's granted access.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProxies STDIO-based MCP clients to streaming HTTP MCP servers, enabling local clients to connect to remote servers.24 npm3MIT
- AlicenseNot gradedqualityBmaintenanceA local stdio MCP server that authenticates to remote OAuth-protected MCP servers using the client_credentials grant, handling token acquisition and request forwarding.85 npm2Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA thin stdio-to-HTTPS proxy that connects local MCP clients to the hosted Voris MCP server, forwarding JSON-RPC messages verbatim.51 npmMIT
- FlicenseNot gradedqualityCmaintenanceProvides 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.-