3xui-mcp
3xui-mcp
用于 3x-ui 面板的 MCP(模型上下文协议)服务器,基于 3xui-api-client 构建。
有意限定范围以保持工具上下文精简:读取操作 加上 对入站和客户端的完整 CRUD。节点、分组、地理文件、备份、Xray 配置和面板设置不在范围内——如果需要,可扩展 src/tools/。
工具
工具 | 类型 | 描述 |
| 读取 | 列出所有入站 |
| 读取 | 按 ID 获取单个入站 |
| 写入 | 创建入站 |
| 写入 | 替换入站的配置 |
| 写入 | 删除入站 |
| 读取 | 列出所有入站中的客户端 |
| 读取 | 按邮箱获取单个客户端 |
| 读取 | 获取客户端的流量使用情况 |
| 读取 | 列出当前已连接的客户端 |
| 写入 | 添加客户端并自动生成凭据 |
| 写入 | 更新客户端的限制/到期时间/状态 |
| 写入 | 按邮箱删除客户端 |
Related MCP server: Open WebUI MCP Server
配置
通过环境变量设置凭据——选择一种认证模式:
# Required
THREEXUI_BASE_URL=https://your-panel.example.com
# Cookie auth (admin username/password)
THREEXUI_USERNAME=admin
THREEXUI_PASSWORD=your-password
# OR API token auth (skips username/password)
THREEXUI_API_TOKEN=your-token
# Optional, default "auto"
THREEXUI_PANEL_TYPE=auto # auto | modern | legacy构建与运行
npm install
npm run build
npm start与 MCP 客户端一起使用
添加到客户端的 MCP 配置中(例如 Claude Desktop 的 claude_desktop_config.json):
{
"mcpServers": {
"3xui": {
"command": "node",
"args": ["/absolute/path/to/3xui-mcp/dist/index.js"],
"env": {
"THREEXUI_BASE_URL": "https://your-panel.example.com",
"THREEXUI_USERNAME": "admin",
"THREEXUI_PASSWORD": "your-password"
}
}
}
}发布到 npm 后,command/args 可替换为 "npx" / ["-y", "3xui-mcp"]。
本地测试
npm run inspector针对此服务器打开 MCP Inspector。
代理技能
skills/3xui-mcp/SKILL.md 记录了每个工具的必填/可选字段、单位(GB 与字节、毫秒时间戳)以及驱动此服务器的 AI 代理的常见工作流——请与服务器一起加载它,这样代理就不必仅凭工具描述来猜测输入格式。
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables LLM agents to perform CRUD operations across multiple databases including PostgreSQL, MySQL, and SQL Server using SQLAlchemy. It features configurable permission management and secure connection handling with automatic password redaction.4
- AlicenseBqualityFmaintenanceExposes Open WebUI's admin APIs as tools, allowing AI assistants to manage users, groups, models, knowledge bases, and chats. It enables comprehensive administrative control and resource discovery while respecting the platform's native permission and authentication systems.8210MIT
- AlicenseCqualityDmaintenanceEnables AI agents to manage server infrastructure through the 1Panel API, including Docker containers, databases, and system monitoring. It provides tools for website management, file operations, and application deployment via natural language commands.1528MIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to manage PocketBase databases with comprehensive CRUD, authentication, file management, backup, and hook operations through a standardized protocol.115MIT
Related MCP Connectors
Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
x402-paid agent tools: 18 over HTTP, 14 over stdio. USDC per call, no API key.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/iamhelitha/3xui-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server