# Alpacon MCP Server
> 🚀 **AI-Powered Server Management** - Connect Claude, Cursor, and other AI tools directly to your Alpacon infrastructure
An advanced MCP (Model Context Protocol) server that bridges AI assistants with Alpacon's server management platform, enabling natural language server administration, monitoring, and automation.
[](https://python.org)
[](https://modelcontextprotocol.io)
[](LICENSE)
## ✨ What is Alpacon MCP Server?
The Alpacon MCP Server transforms how you interact with your server infrastructure by connecting AI assistants directly to Alpacon's management platform. Instead of switching between interfaces, you can now manage servers, monitor metrics, execute commands, and troubleshoot issues using natural language.
### 🎯 Key Benefits
- **Natural Language Server Management** - "Show me CPU usage for all web servers in production"
- **AI-Powered Troubleshooting** - "Investigate why server-web-01 is slow and suggest fixes"
- **Multi-Workspace Support** - Connect to your Alpacon workspaces with secure API authentication
- **Real-Time Monitoring Integration** - Access metrics, logs, and events through AI conversations
- **Secure Websh & File Operations** - Execute commands and transfer files via AI interface
## 🌟 Core Features
### 🖥️ **Server Management**
- List and monitor servers in your workspace
- Get detailed system information and specifications
- Create and manage server documentation
- Multi-workspace support with API token management
### 📊 **Real-Time Monitoring**
- CPU, memory, disk, and network metrics
- Performance trend analysis
- Top server identification
- Custom alert rule management
- Comprehensive health dashboards
### 💻 **System Administration**
- User and group management
- Package inventory and updates
- Network interface monitoring
- Disk and partition analysis
- System time and uptime tracking
### 🔧 **Remote Operations**
- Websh sessions for secure shell access
- Command execution with real-time output
- File upload/download via WebFTP
- Session management and monitoring
### 📋 **Event Management**
- Command acknowledgment and tracking
- Event search and filtering
- Execution history and status
- Automated workflow coordination
## 🚀 Quick Start
### For First-Time Users (Recommended)
**Just run this command and follow the interactive setup:**
```bash
uvx alpacon-mcp
```
That's it! The setup wizard will:
1. ✅ Ask for your region (default: ap1)
2. ✅ Ask for your workspace name
3. ✅ Ask for your API token
4. ✅ Save configuration automatically
5. ✅ Test the connection
6. ✅ Show you the Claude Desktop config to copy
**No manual file editing required!**
### Get Your API Token
Before running the setup, get your API token:
1. Visit `https://alpacon.io`
2. Log in to your account
3. Click **"API Token"** in left sidebar
4. Create new token or copy existing one
5. **Configure ACL permissions** (important for command execution)
6. Copy the token (starts with `alpat-...`)
### Connect to Your MCP Client
After setup completes, add the configuration to your MCP client:
```json
{
"mcpServers": {
"alpacon": {
"command": "uvx",
"args": ["alpacon-mcp"]
}
}
}
```
**Client-specific locations:**
- **Claude Desktop**:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- **Cursor**: `.cursor/mcp.json` in your project
- **VS Code**: MCP extension settings
**Restart or reconnect your MCP client** and you're ready! 🎉
---
## 📋 CLI Commands Reference
```bash
uvx alpacon-mcp # Start server (auto-setup if needed)
uvx alpacon-mcp setup # Run setup wizard (shows token file path)
uvx alpacon-mcp setup --local # Use project config instead of global
uvx alpacon-mcp setup --token-file ~/my.json # Use custom file location
uvx alpacon-mcp test # Test your connection
uvx alpacon-mcp list # Show configured workspaces
uvx alpacon-mcp add # Add another workspace (shows path)
```
---
## 🔧 Advanced Installation Options
### Option A: Install UV (if not already installed)
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
### Option B: Manual Configuration
If you prefer to manually configure tokens:
**Global Configuration** (recommended):
```bash
mkdir -p ~/.alpacon-mcp
echo '{
"ap1": {
"production": "alpat-ABC123xyz789...",
"staging": "alpat-DEF456uvw012..."
}
}' > ~/.alpacon-mcp/token.json
```
**Project-Local Configuration**:
```bash
mkdir -p config
echo '{
"ap1": {
"my-workspace": "alpat-ABC123xyz789..."
}
}' > config/token.json
```
**Environment Variables**:
```bash
export ALPACON_MCP_AP1_PRODUCTION_TOKEN="alpat-ABC123xyz789..."
uvx alpacon-mcp
```
### Option C: Development Installation
```bash
git clone https://github.com/alpacax/alpacon-mcp.git
cd alpacon-mcp
uv venv && source .venv/bin/activate
uv install
python main.py
```
---
## 🔌 Connect to Other AI Tools
### Cursor IDE
Create `.cursor/mcp.json` in your project root:
```json
{
"mcpServers": {
"alpacon": {
"command": "uvx",
"args": ["alpacon-mcp"]
}
}
}
```
### VS Code with MCP Extension
Install the MCP extension and add to settings:
```json
{
"mcp.servers": {
"alpacon": {
"command": "uvx",
"args": ["alpacon-mcp"]
}
}
}
```
**Note**: Token configuration is automatically discovered from:
1. `~/.alpacon-mcp/token.json` (global - recommended)
2. `./config/token.json` (project-local)
3. Environment variables
## 💬 Usage Examples
### Server Health Monitoring
> *"Give me a comprehensive health check for server web-01 including CPU, memory, and disk usage for the last 24 hours"*
### Performance Analysis
> *"Show me the top 5 servers with highest CPU usage and analyze performance trends"*
### System Administration
> *"List all users who can login on server web-01 and check for any users with sudo privileges"*
### Automated Troubleshooting
> *"Server web-01 is responding slowly. Help me investigate CPU, memory, disk I/O, and network usage to find the bottleneck"*
### Command Execution
> *"Execute 'systemctl status nginx' on server web-01 and check the service logs"*
### File Management
> *"Upload my config.txt file to /home/user/ on server web-01 and then download the logs folder as a zip"*
### Persistent Shell Sessions
> *"Create a persistent shell connection to server web-01 and run these commands: check disk usage, list running processes, and create a backup directory"*
## 🔧 Available Tools
### 🖥️ Server Management
- **servers_list** - List all servers in workspace
- **server_get** - Get detailed server information
- **server_notes_list** - View server documentation
- **server_note_create** - Create server notes
### 📊 Monitoring & Metrics
- **get_cpu_usage** - CPU utilization metrics
- **get_memory_usage** - Memory consumption data
- **get_disk_usage** - Disk space and I/O metrics
- **get_network_traffic** - Network bandwidth usage
- **get_server_metrics_summary** - Comprehensive health overview
- **get_cpu_top_servers** - Identify performance leaders
### 💻 System Information
- **get_system_info** - Hardware specifications and details
- **get_os_version** - Operating system information
- **list_system_users** - User account management
- **list_system_groups** - Group membership details
- **list_system_packages** - Installed software inventory
- **get_network_interfaces** - Network configuration
- **get_disk_info** - Storage device information
### 🔧 Remote Operations
#### Websh (Shell Access)
- **websh_session_create** - Create secure shell sessions
- **websh_command_execute** - Execute single commands
- **websh_websocket_execute** - Single command via WebSocket
- **websh_channel_connect** - Persistent connection management
- **websh_channel_execute** - Execute commands using persistent channels
- **websh_channels_list** - List active WebSocket channels
- **websh_session_terminate** - Close sessions
#### WebFTP (File Management)
- **webftp_upload_file** - Upload files using S3 presigned URLs
- **webftp_download_file** - Download files/folders (folders as .zip)
- **webftp_uploads_list** - Upload history
- **webftp_downloads_list** - Download history
- **webftp_sessions_list** - Active FTP sessions
### 📋 Event Management
- **list_events** - Browse server events and logs
- **search_events** - Find specific events
- **acknowledge_command** - Confirm command receipt
- **finish_command** - Mark commands as complete
### 🔐 Identity and Access Management (IAM)
**User Management**:
- **iam_users_list** - List workspace IAM users with pagination
- **iam_user_get** - Get detailed user information
- **iam_user_create** - Create new users with group assignment
- **iam_user_update** - Update user details and group memberships
- **iam_user_delete** - Remove users from workspace
- **iam_user_permissions_get** - View effective user permissions
- **iam_user_assign_role** - Assign roles to users
**Group & Role Management**:
- **iam_groups_list** - List all workspace groups
- **iam_group_create** - Create groups with permissions
- **iam_roles_list** - List available roles
- **iam_permissions_list** - View all permissions
**Advanced IAM Features**:
- Workspace-level isolation for multi-tenant security
- Role-based access control (RBAC) implementation
- Group-based permission inheritance
- Comprehensive audit trails and logging
### 🔐 Authentication
- **auth_set_token** - Configure API tokens
- **auth_remove_token** - Remove stored tokens
## 🌍 Supported Platforms
| Platform | Status | Notes |
|----------|--------|-------|
| **Claude Desktop** | ✅ Full Support | Recommended client |
| **Cursor IDE** | ✅ Full Support | Native MCP integration |
| **VS Code** | ✅ Full Support | Requires MCP extension |
| **Continue** | ✅ Full Support | Via MCP protocol |
| **Other MCP Clients** | ✅ Compatible | Standard protocol support |
## 📖 Documentation
- 📚 **[Complete Documentation](docs/README.md)** - Full documentation index
- 🚀 **[Getting Started Guide](docs/getting-started.md)** - Step-by-step setup
- ⚙️ **[Configuration Guide](docs/configuration.md)** - Advanced configuration
- 🔧 **[API Reference](docs/api-reference.md)** - Complete tool documentation
- 💡 **[Usage Examples](docs/examples.md)** - Real-world scenarios
- 🛠️ **[Installation Guide](docs/installation.md)** - Platform-specific setup
- 🔍 **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions
## 🚀 Advanced Usage
### Multi-Workspace Management
```bash
# Configure tokens for multiple workspaces (ap1 region)
python -c "
from utils.token_manager import TokenManager
tm = TokenManager()
tm.set_token('ap1', 'company-prod', 'ap1-company-prod-token')
tm.set_token('ap1', 'company-staging', 'ap1-company-staging-token')
tm.set_token('ap1', 'company-dev', 'ap1-company-dev-token')
"
```
### Custom Config File
```bash
# Use custom config file location
export ALPACON_MCP_CONFIG_FILE="/path/to/custom-tokens.json"
uvx alpacon-mcp
```
### Docker Deployment
```bash
# Build and run with Docker
docker build -t alpacon-mcp .
docker run -v $(pwd)/config:/app/config:ro alpacon-mcp
```
### SSE Mode (HTTP Transport)
```bash
# Run in Server-Sent Events mode for web integration
python main_sse.py
# Server available at http://localhost:8237
```
## 🔒 Security & Best Practices
- **Secure Token Storage** - Tokens encrypted and never committed to git
- **Workspace-Based Access Control** - Separate tokens per workspace environment
- **ACL Configuration Required** - Configure token permissions in Alpacon web interface for command execution
- **Audit Logging** - All operations logged for security review
- **Connection Validation** - API endpoints verified before execution
### ⚠️ Command Execution Limitations
**Important**: Websh and command execution tools can only run **pre-approved commands** configured in your token's ACL settings:
1. **Visit token details** in Alpacon web interface (click on your token)
2. **Configure ACL permissions** for allowed commands, servers, and operations
3. **Commands not in ACL** will be rejected with 403/404 errors
4. **Contact your administrator** if you need additional command permissions
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
- 🐛 **Bug Reports** - Use GitHub issues
- 💡 **Feature Requests** - Open discussions
- 📝 **Documentation** - Help improve guides
- 🔧 **Code Contributions** - Submit pull requests
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
**Ready to transform your server management experience?**
- 📖 Start with our [Getting Started Guide](docs/getting-started.md)
- 🔧 Explore the [API Reference](docs/api-reference.md)
- 💬 Join our community discussions
*Built with ❤️ for the Alpacon ecosystem*
Raw data
{
"_id": null,
"home_page": null,
"name": "alpacon-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": "Alpacon Team <support@alpacon.io>",
"keywords": "ai, alpacon, claude, cursor, infrastructure, mcp, model-context-protocol, monitoring, server-management",
"author": null,
"author_email": "Alpacon Team <support@alpacon.io>",
"download_url": "https://files.pythonhosted.org/packages/98/5a/7375986cc7ba86a746f14f0aa6e9f9fe3827a7dac8bf62e3a2b75ea7af3a/alpacon_mcp-0.4.3.tar.gz",
"platform": null,
"description": "# Alpacon MCP Server\n\n> \ud83d\ude80 **AI-Powered Server Management** - Connect Claude, Cursor, and other AI tools directly to your Alpacon infrastructure\n\nAn advanced MCP (Model Context Protocol) server that bridges AI assistants with Alpacon's server management platform, enabling natural language server administration, monitoring, and automation.\n\n[](https://python.org)\n[](https://modelcontextprotocol.io)\n[](LICENSE)\n\n## \u2728 What is Alpacon MCP Server?\n\nThe Alpacon MCP Server transforms how you interact with your server infrastructure by connecting AI assistants directly to Alpacon's management platform. Instead of switching between interfaces, you can now manage servers, monitor metrics, execute commands, and troubleshoot issues using natural language.\n\n### \ud83c\udfaf Key Benefits\n\n- **Natural Language Server Management** - \"Show me CPU usage for all web servers in production\"\n- **AI-Powered Troubleshooting** - \"Investigate why server-web-01 is slow and suggest fixes\"\n- **Multi-Workspace Support** - Connect to your Alpacon workspaces with secure API authentication\n- **Real-Time Monitoring Integration** - Access metrics, logs, and events through AI conversations\n- **Secure Websh & File Operations** - Execute commands and transfer files via AI interface\n\n## \ud83c\udf1f Core Features\n\n### \ud83d\udda5\ufe0f **Server Management**\n- List and monitor servers in your workspace\n- Get detailed system information and specifications\n- Create and manage server documentation\n- Multi-workspace support with API token management\n\n### \ud83d\udcca **Real-Time Monitoring**\n- CPU, memory, disk, and network metrics\n- Performance trend analysis\n- Top server identification\n- Custom alert rule management\n- Comprehensive health dashboards\n\n### \ud83d\udcbb **System Administration**\n- User and group management\n- Package inventory and updates\n- Network interface monitoring\n- Disk and partition analysis\n- System time and uptime tracking\n\n### \ud83d\udd27 **Remote Operations**\n- Websh sessions for secure shell access\n- Command execution with real-time output\n- File upload/download via WebFTP\n- Session management and monitoring\n\n### \ud83d\udccb **Event Management**\n- Command acknowledgment and tracking\n- Event search and filtering\n- Execution history and status\n- Automated workflow coordination\n\n## \ud83d\ude80 Quick Start\n\n### For First-Time Users (Recommended)\n\n**Just run this command and follow the interactive setup:**\n\n```bash\nuvx alpacon-mcp\n```\n\nThat's it! The setup wizard will:\n1. \u2705 Ask for your region (default: ap1)\n2. \u2705 Ask for your workspace name\n3. \u2705 Ask for your API token\n4. \u2705 Save configuration automatically\n5. \u2705 Test the connection\n6. \u2705 Show you the Claude Desktop config to copy\n\n**No manual file editing required!**\n\n### Get Your API Token\n\nBefore running the setup, get your API token:\n\n1. Visit `https://alpacon.io`\n2. Log in to your account\n3. Click **\"API Token\"** in left sidebar\n4. Create new token or copy existing one\n5. **Configure ACL permissions** (important for command execution)\n6. Copy the token (starts with `alpat-...`)\n\n### Connect to Your MCP Client\n\nAfter setup completes, add the configuration to your MCP client:\n\n```json\n{\n \"mcpServers\": {\n \"alpacon\": {\n \"command\": \"uvx\",\n \"args\": [\"alpacon-mcp\"]\n }\n }\n}\n```\n\n**Client-specific locations:**\n- **Claude Desktop**:\n - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Cursor**: `.cursor/mcp.json` in your project\n- **VS Code**: MCP extension settings\n\n**Restart or reconnect your MCP client** and you're ready! \ud83c\udf89\n\n---\n\n## \ud83d\udccb CLI Commands Reference\n\n```bash\nuvx alpacon-mcp # Start server (auto-setup if needed)\nuvx alpacon-mcp setup # Run setup wizard (shows token file path)\nuvx alpacon-mcp setup --local # Use project config instead of global\nuvx alpacon-mcp setup --token-file ~/my.json # Use custom file location\nuvx alpacon-mcp test # Test your connection\nuvx alpacon-mcp list # Show configured workspaces\nuvx alpacon-mcp add # Add another workspace (shows path)\n```\n\n---\n\n## \ud83d\udd27 Advanced Installation Options\n\n### Option A: Install UV (if not already installed)\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n### Option B: Manual Configuration\n\nIf you prefer to manually configure tokens:\n\n**Global Configuration** (recommended):\n```bash\nmkdir -p ~/.alpacon-mcp\necho '{\n \"ap1\": {\n \"production\": \"alpat-ABC123xyz789...\",\n \"staging\": \"alpat-DEF456uvw012...\"\n }\n}' > ~/.alpacon-mcp/token.json\n```\n\n**Project-Local Configuration**:\n```bash\nmkdir -p config\necho '{\n \"ap1\": {\n \"my-workspace\": \"alpat-ABC123xyz789...\"\n }\n}' > config/token.json\n```\n\n**Environment Variables**:\n```bash\nexport ALPACON_MCP_AP1_PRODUCTION_TOKEN=\"alpat-ABC123xyz789...\"\nuvx alpacon-mcp\n```\n\n### Option C: Development Installation\n```bash\ngit clone https://github.com/alpacax/alpacon-mcp.git\ncd alpacon-mcp\nuv venv && source .venv/bin/activate\nuv install\npython main.py\n```\n\n---\n\n## \ud83d\udd0c Connect to Other AI Tools\n\n### Cursor IDE\n\nCreate `.cursor/mcp.json` in your project root:\n\n```json\n{\n \"mcpServers\": {\n \"alpacon\": {\n \"command\": \"uvx\",\n \"args\": [\"alpacon-mcp\"]\n }\n }\n}\n```\n\n### VS Code with MCP Extension\n\nInstall the MCP extension and add to settings:\n\n```json\n{\n \"mcp.servers\": {\n \"alpacon\": {\n \"command\": \"uvx\",\n \"args\": [\"alpacon-mcp\"]\n }\n }\n}\n```\n\n**Note**: Token configuration is automatically discovered from:\n1. `~/.alpacon-mcp/token.json` (global - recommended)\n2. `./config/token.json` (project-local)\n3. Environment variables\n\n## \ud83d\udcac Usage Examples\n\n### Server Health Monitoring\n> *\"Give me a comprehensive health check for server web-01 including CPU, memory, and disk usage for the last 24 hours\"*\n\n### Performance Analysis\n> *\"Show me the top 5 servers with highest CPU usage and analyze performance trends\"*\n\n### System Administration\n> *\"List all users who can login on server web-01 and check for any users with sudo privileges\"*\n\n### Automated Troubleshooting\n> *\"Server web-01 is responding slowly. Help me investigate CPU, memory, disk I/O, and network usage to find the bottleneck\"*\n\n### Command Execution\n> *\"Execute 'systemctl status nginx' on server web-01 and check the service logs\"*\n\n### File Management\n> *\"Upload my config.txt file to /home/user/ on server web-01 and then download the logs folder as a zip\"*\n\n### Persistent Shell Sessions\n> *\"Create a persistent shell connection to server web-01 and run these commands: check disk usage, list running processes, and create a backup directory\"*\n\n## \ud83d\udd27 Available Tools\n\n### \ud83d\udda5\ufe0f Server Management\n- **servers_list** - List all servers in workspace\n- **server_get** - Get detailed server information\n- **server_notes_list** - View server documentation\n- **server_note_create** - Create server notes\n\n### \ud83d\udcca Monitoring & Metrics\n- **get_cpu_usage** - CPU utilization metrics\n- **get_memory_usage** - Memory consumption data\n- **get_disk_usage** - Disk space and I/O metrics\n- **get_network_traffic** - Network bandwidth usage\n- **get_server_metrics_summary** - Comprehensive health overview\n- **get_cpu_top_servers** - Identify performance leaders\n\n### \ud83d\udcbb System Information\n- **get_system_info** - Hardware specifications and details\n- **get_os_version** - Operating system information\n- **list_system_users** - User account management\n- **list_system_groups** - Group membership details\n- **list_system_packages** - Installed software inventory\n- **get_network_interfaces** - Network configuration\n- **get_disk_info** - Storage device information\n\n### \ud83d\udd27 Remote Operations\n\n#### Websh (Shell Access)\n- **websh_session_create** - Create secure shell sessions\n- **websh_command_execute** - Execute single commands\n- **websh_websocket_execute** - Single command via WebSocket\n- **websh_channel_connect** - Persistent connection management\n- **websh_channel_execute** - Execute commands using persistent channels\n- **websh_channels_list** - List active WebSocket channels\n- **websh_session_terminate** - Close sessions\n\n#### WebFTP (File Management)\n- **webftp_upload_file** - Upload files using S3 presigned URLs\n- **webftp_download_file** - Download files/folders (folders as .zip)\n- **webftp_uploads_list** - Upload history\n- **webftp_downloads_list** - Download history\n- **webftp_sessions_list** - Active FTP sessions\n\n### \ud83d\udccb Event Management\n- **list_events** - Browse server events and logs\n- **search_events** - Find specific events\n- **acknowledge_command** - Confirm command receipt\n- **finish_command** - Mark commands as complete\n\n### \ud83d\udd10 Identity and Access Management (IAM)\n\n**User Management**:\n- **iam_users_list** - List workspace IAM users with pagination\n- **iam_user_get** - Get detailed user information\n- **iam_user_create** - Create new users with group assignment\n- **iam_user_update** - Update user details and group memberships\n- **iam_user_delete** - Remove users from workspace\n- **iam_user_permissions_get** - View effective user permissions\n- **iam_user_assign_role** - Assign roles to users\n\n**Group & Role Management**:\n- **iam_groups_list** - List all workspace groups\n- **iam_group_create** - Create groups with permissions\n- **iam_roles_list** - List available roles\n- **iam_permissions_list** - View all permissions\n\n**Advanced IAM Features**:\n- Workspace-level isolation for multi-tenant security\n- Role-based access control (RBAC) implementation\n- Group-based permission inheritance\n- Comprehensive audit trails and logging\n\n### \ud83d\udd10 Authentication\n- **auth_set_token** - Configure API tokens\n- **auth_remove_token** - Remove stored tokens\n\n## \ud83c\udf0d Supported Platforms\n\n| Platform | Status | Notes |\n|----------|--------|-------|\n| **Claude Desktop** | \u2705 Full Support | Recommended client |\n| **Cursor IDE** | \u2705 Full Support | Native MCP integration |\n| **VS Code** | \u2705 Full Support | Requires MCP extension |\n| **Continue** | \u2705 Full Support | Via MCP protocol |\n| **Other MCP Clients** | \u2705 Compatible | Standard protocol support |\n\n## \ud83d\udcd6 Documentation\n\n- \ud83d\udcda **[Complete Documentation](docs/README.md)** - Full documentation index\n- \ud83d\ude80 **[Getting Started Guide](docs/getting-started.md)** - Step-by-step setup\n- \u2699\ufe0f **[Configuration Guide](docs/configuration.md)** - Advanced configuration\n- \ud83d\udd27 **[API Reference](docs/api-reference.md)** - Complete tool documentation\n- \ud83d\udca1 **[Usage Examples](docs/examples.md)** - Real-world scenarios\n- \ud83d\udee0\ufe0f **[Installation Guide](docs/installation.md)** - Platform-specific setup\n- \ud83d\udd0d **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions\n\n## \ud83d\ude80 Advanced Usage\n\n### Multi-Workspace Management\n```bash\n# Configure tokens for multiple workspaces (ap1 region)\npython -c \"\nfrom utils.token_manager import TokenManager\ntm = TokenManager()\ntm.set_token('ap1', 'company-prod', 'ap1-company-prod-token')\ntm.set_token('ap1', 'company-staging', 'ap1-company-staging-token')\ntm.set_token('ap1', 'company-dev', 'ap1-company-dev-token')\n\"\n```\n\n### Custom Config File\n```bash\n# Use custom config file location\nexport ALPACON_MCP_CONFIG_FILE=\"/path/to/custom-tokens.json\"\nuvx alpacon-mcp\n```\n\n### Docker Deployment\n```bash\n# Build and run with Docker\ndocker build -t alpacon-mcp .\ndocker run -v $(pwd)/config:/app/config:ro alpacon-mcp\n```\n\n### SSE Mode (HTTP Transport)\n```bash\n# Run in Server-Sent Events mode for web integration\npython main_sse.py\n# Server available at http://localhost:8237\n```\n\n## \ud83d\udd12 Security & Best Practices\n\n- **Secure Token Storage** - Tokens encrypted and never committed to git\n- **Workspace-Based Access Control** - Separate tokens per workspace environment\n- **ACL Configuration Required** - Configure token permissions in Alpacon web interface for command execution\n- **Audit Logging** - All operations logged for security review\n- **Connection Validation** - API endpoints verified before execution\n\n### \u26a0\ufe0f Command Execution Limitations\n\n**Important**: Websh and command execution tools can only run **pre-approved commands** configured in your token's ACL settings:\n\n1. **Visit token details** in Alpacon web interface (click on your token)\n2. **Configure ACL permissions** for allowed commands, servers, and operations\n3. **Commands not in ACL** will be rejected with 403/404 errors\n4. **Contact your administrator** if you need additional command permissions\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n- \ud83d\udc1b **Bug Reports** - Use GitHub issues\n- \ud83d\udca1 **Feature Requests** - Open discussions\n- \ud83d\udcdd **Documentation** - Help improve guides\n- \ud83d\udd27 **Code Contributions** - Submit pull requests\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n**Ready to transform your server management experience?**\n- \ud83d\udcd6 Start with our [Getting Started Guide](docs/getting-started.md)\n- \ud83d\udd27 Explore the [API Reference](docs/api-reference.md)\n- \ud83d\udcac Join our community discussions\n\n*Built with \u2764\ufe0f for the Alpacon ecosystem* ",
"bugtrack_url": null,
"license": "MIT",
"summary": "AI-Powered Server Management - Connect Claude, Cursor, and other AI tools directly to your Alpacon infrastructure",
"version": "0.4.3",
"project_urls": {
"Changelog": "https://github.com/alpacax/alpacon-mcp/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/alpacax/alpacon-mcp/blob/main/docs/README.md",
"Homepage": "https://github.com/alpacax/alpacon-mcp",
"Issues": "https://github.com/alpacax/alpacon-mcp/issues",
"Repository": "https://github.com/alpacax/alpacon-mcp.git"
},
"split_keywords": [
"ai",
" alpacon",
" claude",
" cursor",
" infrastructure",
" mcp",
" model-context-protocol",
" monitoring",
" server-management"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e6119c3fef67bac938d784718bdf983fdf16888fd597697d04d6ec1a9ccd04d0",
"md5": "c110f4dada7b9ca6a0ac31fbebf99d68",
"sha256": "a1c4389b68e91a7ad8bd3b463c5b9e58b8b090de4ed90d066fee4424eb8135e3"
},
"downloads": -1,
"filename": "alpacon_mcp-0.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c110f4dada7b9ca6a0ac31fbebf99d68",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 201880,
"upload_time": "2025-10-24T10:22:45",
"upload_time_iso_8601": "2025-10-24T10:22:45.686270Z",
"url": "https://files.pythonhosted.org/packages/e6/11/9c3fef67bac938d784718bdf983fdf16888fd597697d04d6ec1a9ccd04d0/alpacon_mcp-0.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "985a7375986cc7ba86a746f14f0aa6e9f9fe3827a7dac8bf62e3a2b75ea7af3a",
"md5": "ab4fc751ec7c9f3aa27a70b3f0651aa5",
"sha256": "0494d5ae2387468185dda3c81c3dbd78b9ca77c1637c55f8b861f1f233d739c9"
},
"downloads": -1,
"filename": "alpacon_mcp-0.4.3.tar.gz",
"has_sig": false,
"md5_digest": "ab4fc751ec7c9f3aa27a70b3f0651aa5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 155853,
"upload_time": "2025-10-24T10:22:47",
"upload_time_iso_8601": "2025-10-24T10:22:47.041272Z",
"url": "https://files.pythonhosted.org/packages/98/5a/7375986cc7ba86a746f14f0aa6e9f9fe3827a7dac8bf62e3a2b75ea7af3a/alpacon_mcp-0.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-24 10:22:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alpacax",
"github_project": "alpacon-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "alpacon-mcp"
}
JSON
