Uno MCP Stdio

一个MCP STDIO

](https://pypi.org/project/uno-mcp-stdio/)  

Uno MCP网关的本地stdio代理 -为不支持OAuth身份验证的MCP客户端提供本地代理。

🎯 问题解决了

许多MCP客户端（如Manus、Cherry Studio）不支持OAuth 2.0身份验证，无法直接连接到需要身份验证的MCP服务器。

uno-mcp-stdio 充当本地代理：

1. 使用stdio模式与MCP客户端通信（所有客户端都支持）
2. 在本地安全地存储OAuth令牌
3. 将请求代理到远程Uno网关，自动附加身份验证信息

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

🚀 快速开始

安装

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

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

首映

首次运行时需要OAuth身份验证：

$ 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

配置MCP客户端

在MCP客户端中配置stdio服务器：

Manus/Cherry工作室配置示例：

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

如果与pip一起安装：

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

⚙️ 配置

环境变量

令牌存储

经过身份验证的令牌存储在 ~/.uno-mcp/credentials.json:

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

清除身份验证

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

🔐 身份验证流程

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

🛠️ 发展

# 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

📄 许可证

麻省理工学院

🌐 语言

• 英语 （当前）
• 中文