{"_id":"1panel-mcp-server","name":"1panel-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"1panel-mcp-server","version":"1.0.0","description":"MCP server for 1Panel - Model Context Protocol server for managing 1Panel through AI agents","main":"dist/index.js","type":"module","bin":{"1panel-mcp-server":"dist/cli.js","1pmcp":"dist/cli.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepare":"npm run build"},"keywords":["mcp","1panel","model-context-protocol","ai","server-management","cli"],"author":"","license":"MIT","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","commander":"^12.1.0"},"devDependencies":{"@types/node":"^20.19.37","typescript":"^5.9.3"},"_id":"1panel-mcp-server@1.0.0","gitHead":"0e0b1c65f06259964a597433b05a54d678e54169","types":"./dist/index.d.ts","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-i1zoSTRwyTqDMkQKI1RaJsAlTjH4gdqOUoUV6oM7DwC/KQLZKAlt9vDiC3tdv3e+x9J7U7IL4llix22gf8Y7SA==","shasum":"c5c87e70ac4b2afcdf23d4b30afc55d18957974a","tarball":"https://registry.npmjs.org/1panel-mcp-server/-/1panel-mcp-server-1.0.0.tgz","fileCount":295,"unpackedSize":548352,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQClEuDBJdkgZclb05gCyWHZ2Vs4xkP+IksZAM/SRMNYqgIhAOQ/yA0jOw3Y3MEn9xd1iFdwrla7BRK+WksiQJmZnVXC"}]},"_npmUser":{"name":"eaveluo","email":"eaveluo@gmail.com"},"directories":{},"maintainers":[{"name":"eaveluo","email":"eaveluo@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/1panel-mcp-server_1.0.0_1773858356379_0.5381188264582666"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-18T18:25:56.286Z","1.0.0":"2026-03-18T18:25:56.556Z","modified":"2026-03-18T18:25:56.773Z"},"maintainers":[{"name":"eaveluo","email":"eaveluo@gmail.com"}],"description":"MCP server for 1Panel - Model Context Protocol server for managing 1Panel through AI agents","keywords":["mcp","1panel","model-context-protocol","ai","server-management","cli"],"license":"MIT","readme":"# 1Panel MCP\n\n[![npm version](https://img.shields.io/npm/v/1panel-mcp.svg)](https://www.npmjs.com/package/1panel-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMCP (Model Context Protocol) server for 1Panel - Manage your 1Panel through AI agents like Claude, Cursor, or any MCP-compatible client.\n\n## Features\n\n- **264 Tools** covering 1Panel's complete API\n- **100% Open Source** version coverage\n- **~90% Professional (XPack)** version coverage\n- Modular architecture with TypeScript\n\n### Supported Modules\n\n**Core:** Containers, Images, Networks, Volumes, Docker Compose\n**Applications:** App Store, Runtime Environments, PHP, Node.js\n**Files:** File Management, Backup, Recycle Bin, Snapshots\n**Database:** MySQL, PostgreSQL, Redis\n**Website:** Websites, SSL, Nginx, AntiLeech\n**System:** Monitor, Processes, Cronjobs, Firewall, Fail2ban\n**Security:** SSH, Terminal, ClamAV Antivirus\n**AI & Advanced:** AI Agent, MCP Server, Ollama, GPU, OpenResty\n**Host Management:** Remote Hosts, SSH Keys\n\n## Installation\n\n### Global Installation (Recommended)\n\n```bash\nnpm install -g 1panel-mcp\n```\n\n### Local Installation\n\n```bash\nnpm install 1panel-mcp\n```\n\n## Usage\n\n### Quick Start\n\n1. **Get your 1Panel API key:**\n   - Login to 1Panel web interface\n   - Go to Profile → API\n   - Generate or copy your API key\n\n2. **Start the MCP server:**\n\n```bash\n# Using environment variables\nexport ONEPANEL_API_KEY=your-api-key\nexport ONEPANEL_HOST=localhost\nexport ONEPANEL_PORT=8080\n1panel-mcp start\n\n# Using command line options\n1panel-mcp start --host 192.168.1.100 --port 8080 --key your-api-key\n\n# Using HTTPS\n1panel-mcp start --host panel.example.com --secure --key your-api-key\n```\n\n### Commands\n\n```bash\n1panel-mcp --help              # Show help\n1panel-mcp start --help        # Show start options\n1panel-mcp config              # Show configuration guide\n1panel-mcp tools               # List available tools\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `ONEPANEL_HOST` | 1Panel host | `localhost` |\n| `ONEPANEL_PORT` | 1Panel port | `8080` |\n| `ONEPANEL_API_KEY` | 1Panel API key (required) | - |\n| `ONEPANEL_PROTOCOL` | `http` or `https` | `http` |\n\n## MCP Configuration\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"1panel\": {\n      \"command\": \"1panel-mcp\",\n      \"args\": [\"start\"],\n      \"env\": {\n        \"ONEPANEL_HOST\": \"localhost\",\n        \"ONEPANEL_PORT\": \"8080\",\n        \"ONEPANEL_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to Cursor MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"1panel\": {\n      \"command\": \"1panel-mcp\",\n      \"args\": [\"start\", \"--host\", \"localhost\", \"--port\", \"8080\", \"--key\", \"your-api-key\"]\n    }\n  }\n}\n```\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/EaveLuo/1panel-mcp.git\ncd 1panel-mcp\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Development mode\nnpm run dev\n\n# Start locally\nnpm start\n```\n\n## API Coverage\n\n| Category | Tools | Coverage |\n|----------|-------|----------|\n| Open Source | 205 | 100% |\n| XPack (Pro) | 59 | ~90% |\n| **Total** | **264** | **~98%** |\n\n## License\n\nMIT\n\n## Links\n\n- [GitHub](https://github.com/EaveLuo/1panel-mcp)\n- [npm](https://www.npmjs.com/package/1panel-mcp)\n- [1Panel](https://1panel.cn/)\n","readmeFilename":"README.md","_rev":"1-e5fbceb08c9ac846f7ca2924067cb27f"}