3xui-mcp
3xui-mcp
3x-ui 패널용 MCP(Model Context Protocol) 서버로, 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 startMCP 클라이언트와 함께 사용
클라이언트의 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는 이 서버를 구동하는 AI 에이전트를 위해 모든 도구의 필수/선택 필드, 단위(GB 대 바이트, ms 타임스탬프), 일반적인 워크플로를 문서화합니다 — 에이전트가 도구 설명만으로 입력 형태를 추측하지 않도록 서버와 함께 로드하세요.
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