liara-mcp 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +60 -10
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # Liara MCP Server
2
2
 
3
+ > **Note**: This is an **unofficial** MCP server for the Liara cloud platform. It is not affiliated with or endorsed by Liara.
4
+
3
5
  A Model Context Protocol (MCP) server for the Liara cloud platform. This server enables AI assistants to deploy and manage applications, databases, and infrastructure on Liara through natural language.
4
6
 
5
7
  ## Features
@@ -8,9 +10,16 @@ A Model Context Protocol (MCP) server for the Liara cloud platform. This server
8
10
 
9
11
  - **App Management**: Create, deploy, start, stop, restart, and delete apps across 14+ platforms
10
12
  - **Environment Variables**: Set and update environment variables for apps
11
- - **Deployment**: Deploy releases to apps
13
+ - **Deployment**: Deploy releases, upload sources, rollback to previous versions
12
14
  - **Database Management**: Create, manage, and backup databases (MySQL, PostgreSQL, MongoDB, Redis, etc.)
13
- - **Object Storage**: Manage S3-compatible storage buckets
15
+ - **Object Storage**: Manage S3-compatible storage buckets and objects
16
+ - **DNS Management**: Complete DNS zone and record management
17
+ - **Domain Management**: Add, remove, and verify domains for apps
18
+ - **Disk Management**: Create and manage disks with FTP access
19
+ - **Mail Servers**: Create and manage mail servers, send emails
20
+ - **Virtual Machines (IaaS)**: Full VM lifecycle management with snapshots
21
+ - **Network Management**: Create and manage networks for VMs
22
+ - **Observability**: Retrieve app metrics and logs
14
23
  - **Plans**: List and view available resource plans
15
24
 
16
25
  ### Supported Platforms
@@ -37,7 +46,7 @@ npm install liara-mcp
37
46
 
38
47
  ```bash
39
48
  # Clone the repository
40
- git clone https://github.com/YOUR_USERNAME/liara-mcp.git
49
+ git clone https://github.com/razavioo/liara-mcp.git
41
50
  cd liara-mcp
42
51
 
43
52
  # Install dependencies
@@ -63,9 +72,10 @@ LIARA_API_BASE_URL=https://api.iran.liara.ir
63
72
 
64
73
  ### Getting Your API Token
65
74
 
66
- 1. Log in to [Liara Console](https://console.liara.ir)
67
- 2. Navigate to the API section in your account menu
68
- 3. Click "Create new key" to generate your API token
75
+ 1. Go directly to the [API section](https://console.liara.ir/API) in Liara Console (or log in to [Liara Console](https://console.liara.ir) and navigate to the API section)
76
+ 2. Select an expiration timeline for your API key (options: 1 hour, 1 day, 7 days, 1 month, 6 months, or 1 year)
77
+ 3. Click "Create new key" (ساخت کلید جدید) to generate your API token
78
+ 4. Copy the generated token immediately - it will only be shown once
69
79
 
70
80
  ### Team ID (Optional)
71
81
 
@@ -335,19 +345,59 @@ The server provides user-friendly error messages for common scenarios:
335
345
 
336
346
  MIT
337
347
 
348
+ ## API Coverage
349
+
350
+ This MCP server implements comprehensive coverage of the [Liara API](https://openapi.liara.ir), including:
351
+
352
+ ### Implemented Services (15 modules, 70+ tools)
353
+
354
+ - **Apps** - Full lifecycle management (create, deploy, start, stop, restart, resize)
355
+ - **Databases** - Complete database management with backup/restore (8 database types)
356
+ - **Deployment** - Source upload, release management, rollback
357
+ - **Environment Variables** - Set, get, delete environment variables
358
+ - **Object Storage** - S3-compatible bucket and object management
359
+ - **Disks** - Disk management with FTP access
360
+ - **DNS** - Complete DNS zone and record management
361
+ - **Domains** - Domain management and verification
362
+ - **Mail Servers** - Mail server management and email sending
363
+ - **Virtual Machines (IaaS)** - VM lifecycle, snapshots, network attachment
364
+ - **Networks** - Network management for VMs
365
+ - **Observability** - Metrics and logs retrieval
366
+ - **Plans** - Resource plan information
367
+ - **Settings** - App configuration (zero-downtime, subdomain, IP, read-only)
368
+ - **User** - User account information
369
+
370
+ ### API Documentation Reference
371
+
372
+ This implementation is based on the [Liara OpenAPI specification](https://openapi.liara.ir) and covers:
373
+ - All major platform services (PaaS, DBaaS, IaaS, Object Storage, DNS, Mail)
374
+ - CI/CD capabilities through deployment tools
375
+ - Complete resource lifecycle management
376
+ - Error handling aligned with Liara API responses
377
+
338
378
  ## Resources
339
379
 
340
380
  - [Liara Documentation](https://docs.liara.ir)
341
381
  - [Liara API Reference](https://openapi.liara.ir)
382
+ - [Liara Console](https://console.liara.ir)
342
383
  - [Model Context Protocol](https://modelcontextprotocol.io)
343
384
 
385
+ ## Disclaimer
386
+
387
+ This is an **unofficial** MCP server implementation for Liara. It is:
388
+ - Not affiliated with, endorsed by, or supported by Liara
389
+ - Maintained by the community
390
+ - Provided as-is without warranty
391
+
392
+ For official Liara support, please contact [Liara Support](https://liara.ir).
393
+
344
394
  ## Contributing
345
395
 
346
- Contributions are welcome! Please feel free to submit issues or pull requests.
396
+ Contributions are welcome! Please feel free to submit issues or pull requests on [GitHub](https://github.com/razavioo/liara-mcp).
347
397
 
348
398
  ## Support
349
399
 
350
400
  For issues related to:
351
- - This MCP server: Open an issue on GitHub
352
- - Liara platform: Contact [Liara Support](https://liara.ir)
353
- - MCP protocol: See [MCP Documentation](https://modelcontextprotocol.io)
401
+ - **This MCP server**: Open an issue on [GitHub](https://github.com/razavioo/liara-mcp/issues)
402
+ - **Liara platform**: Contact [Liara Support](https://liara.ir)
403
+ - **MCP protocol**: See [MCP Documentation](https://modelcontextprotocol.io)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "liara-mcp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "MCP server for Liara cloud platform - deploy and manage apps, databases, and infrastructure",
5
5
  "main": "dist/index.js",
6
6
  "type": "module",
@@ -40,12 +40,12 @@
40
40
  "license": "MIT",
41
41
  "repository": {
42
42
  "type": "git",
43
- "url": "https://github.com/YOUR_USERNAME/liara-mcp.git"
43
+ "url": "https://github.com/razavioo/liara-mcp.git"
44
44
  },
45
45
  "bugs": {
46
- "url": "https://github.com/YOUR_USERNAME/liara-mcp/issues"
46
+ "url": "https://github.com/razavioo/liara-mcp/issues"
47
47
  },
48
- "homepage": "https://github.com/YOUR_USERNAME/liara-mcp#readme",
48
+ "homepage": "https://github.com/razavioo/liara-mcp#readme",
49
49
  "dependencies": {
50
50
  "@modelcontextprotocol/sdk": "^0.5.0",
51
51
  "@types/form-data": "^2.2.1",