liara-mcp 0.1.2 → 0.1.3

package/README.md

@@ -4,6 +4,10 @@
 
 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.
 
+<div align="center">
+  <img src="assets/liara-mcp-logo.jpg" alt="Liara MCP Server" width="600">
+</div>
+
 ## Features
 
 ### Current Capabilities
@@ -32,31 +36,21 @@ MariaDB, MySQL, PostgreSQL, MSSQL, MongoDB, Redis, ElasticSearch, RabbitMQ
 
 ## Installation
 
-### Via npm (Recommended)
-
 ```bash
-# Install globally
 npm install -g liara-mcp
-
-# Or install locally in your project
-npm install liara-mcp
 ```
 
-### From Source
+Or use directly with npx (no installation required).
 
-```bash
-# Clone the repository
-git clone https://github.com/razavioo/liara-mcp.git
-cd liara-mcp
+## Configuration
 
-# Install dependencies
-npm install
+The server supports multiple ways to configure your API token:
 
-# Build the TypeScript code
-npm run build
-```
+### Option 1: Environment Variables (Recommended for MCP clients)
 
-## Configuration
+Set the token directly in your MCP client configuration (see Usage section below).
+
+### Option 2: .env File (For local development)
 
 1. Copy the example environment file:
 ```bash
@@ -70,6 +64,8 @@ LIARA_TEAM_ID=optional_team_id
 LIARA_API_BASE_URL=https://api.iran.liara.ir
 ```
 
+The server automatically loads `.env` files using dotenv, so no additional setup is required.
+
 ### Getting Your API Token
 
 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)
@@ -83,17 +79,18 @@ If you're working with a team account, you can find your Team ID in the API sect
 
 ## Usage
 
-### With MCP Client
-
-#### If installed globally via npm:
+### With Claude Desktop / Cursor / VS Code
 
-Add to your MCP client configuration (e.g., Claude Desktop):
+Add the following to your MCP configuration file:
+- **Claude Desktop:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
+- **Cursor:** `.cursor/mcp.json`
 
 ```json
 {
   "mcpServers": {
     "liara": {
-      "command": "liara-mcp",
+      "command": "npx",
+      "args": ["-y", "liara-mcp"],
       "env": {
         "LIARA_API_TOKEN": "your_api_token_here"
       }
@@ -102,22 +99,16 @@ Add to your MCP client configuration (e.g., Claude Desktop):
 }
 ```
 
-#### If installed locally or from source:
+### Troubleshooting: PATH Issues (nvm/nodenv users)
 
-```json
-{
-  "mcpServers": {
-    "liara": {
-      "command": "node",
-      "args": ["/path/to/liara-mcp/dist/index.js"],
-      "env": {
-        "LIARA_API_TOKEN": "your_api_token_here"
-      }
-    }
-  }
-}
+If you see `spawn npx ENOENT` error, run the setup wizard:
+
+```bash
+npx liara-mcp-setup
 ```
 
+This will generate the correct configuration with absolute paths for your system.
+
 ### Available Tools
 
 #### App Management

package/bin/setup.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+
+import { execSync, spawn } from 'child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { createInterface } from 'readline';
+import { homedir, platform } from 'os';
+
+const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+});
+
+function question(prompt) {
+    return new Promise((resolve) => {
+        rl.question(prompt, resolve);
+    });
+}
+
+function getNodePath() {
+    try {
+        return execSync('which node', { encoding: 'utf8' }).trim();
+    } catch {
+        return null;
+    }
+}
+
+function getLiaraMcpPath(nodeDir) {
+    const nodeModulesDir = join(dirname(nodeDir), 'lib', 'node_modules');
+    const liaraMcpPath = join(nodeModulesDir, 'liara-mcp', 'dist', 'index.js');
+    
+    if (existsSync(liaraMcpPath)) {
+        return liaraMcpPath;
+    }
+    return null;
+}
+
+function getCursorConfigPath() {
+    const home = homedir();
+    return join(home, '.cursor', 'mcp.json');
+}
+
+function getClaudeConfigPath() {
+    const home = homedir();
+    if (platform() === 'darwin') {
+        return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+}
+
+async function main() {
+    console.log('🚀 Liara MCP Setup');
+    console.log('==================');
+    console.log('');
+
+    // Check Node.js
+    const nodePath = getNodePath();
+    if (!nodePath) {
+        console.log('❌ Node.js is not installed. Please install Node.js first.');
+        console.log('   Visit: https://nodejs.org/');
+        process.exit(1);
+    }
+    console.log(`✅ Found Node.js at: ${nodePath}`);
+
+    const nodeDir = dirname(nodePath);
+    
+    // Check liara-mcp
+    let liaraMcpPath = getLiaraMcpPath(nodeDir);
+    
+    if (!liaraMcpPath) {
+        console.log('');
+        console.log('📦 Installing liara-mcp globally...');
+        try {
+            execSync('npm install -g liara-mcp', { stdio: 'inherit' });
+            liaraMcpPath = getLiaraMcpPath(nodeDir);
+        } catch (error) {
+            console.log('❌ Failed to install liara-mcp');
+            process.exit(1);
+        }
+    }
+
+    if (!liaraMcpPath) {
+        console.log('❌ liara-mcp not found. Please run: npm install -g liara-mcp');
+        process.exit(1);
+    }
+
+    console.log(`✅ Found liara-mcp at: ${liaraMcpPath}`);
+    console.log('');
+
+    // Get API token
+    const apiToken = await question('🔑 Enter your Liara API token (get it from https://console.liara.ir/API): ');
+    
+    if (!apiToken || apiToken.trim() === '') {
+        console.log('❌ API token is required');
+        rl.close();
+        process.exit(1);
+    }
+
+    // Generate config
+    const config = {
+        mcpServers: {
+            liara: {
+                command: nodePath,
+                args: [liaraMcpPath],
+                env: {
+                    LIARA_API_TOKEN: apiToken.trim()
+                }
+            }
+        }
+    };
+
+    console.log('');
+    console.log('📝 Your MCP configuration:');
+    console.log('');
+    console.log('━'.repeat(60));
+    console.log(JSON.stringify(config, null, 2));
+    console.log('━'.repeat(60));
+    console.log('');
+
+    const cursorConfigPath = getCursorConfigPath();
+    const claudeConfigPath = getClaudeConfigPath();
+
+    console.log('📁 Configuration file locations:');
+    console.log(`   Cursor: ${cursorConfigPath}`);
+    console.log(`   Claude Desktop: ${claudeConfigPath}`);
+    console.log('');
+
+    const autoConfig = await question('Would you like to automatically configure Cursor? (y/n): ');
+
+    if (autoConfig.toLowerCase() === 'y') {
+        try {
+            const configDir = dirname(cursorConfigPath);
+            if (!existsSync(configDir)) {
+                mkdirSync(configDir, { recursive: true });
+            }
+
+            let finalConfig = config;
+
+            // Merge with existing config if present
+            if (existsSync(cursorConfigPath)) {
+                console.log('⚠️  Existing config found. Creating backup...');
+                copyFileSync(cursorConfigPath, `${cursorConfigPath}.backup`);
+                
+                try {
+                    const existing = JSON.parse(readFileSync(cursorConfigPath, 'utf8'));
+                    existing.mcpServers = existing.mcpServers || {};
+                    existing.mcpServers.liara = config.mcpServers.liara;
+                    finalConfig = existing;
+                } catch {
+                    // Use new config if parsing fails
+                }
+            }
+
+            writeFileSync(cursorConfigPath, JSON.stringify(finalConfig, null, 2));
+            console.log(`✅ Configuration written to ${cursorConfigPath}`);
+            console.log('');
+            console.log('🎉 Setup complete! Please restart Cursor to apply changes.');
+        } catch (error) {
+            console.log(`❌ Failed to write config: ${error.message}`);
+            console.log('   Please copy the configuration manually.');
+        }
+    } else {
+        console.log('');
+        console.log('📋 Copy the configuration above and add it to your MCP client config file.');
+    }
+
+    console.log('');
+    console.log('📚 Documentation: https://github.com/razavioo/liara-mcp');
+    console.log('🆘 Issues: https://github.com/razavioo/liara-mcp/issues');
+
+    rl.close();
+}
+
+main().catch(console.error);
+

package/dist/index.js

@@ -31,7 +31,7 @@ class LiaraMcpServer {
     constructor() {
         this.server = new Server({
             name: 'liara-mcp',
-            version: '0.1.2',
+            version: '0.1.3',
         }, {
             capabilities: {
                 tools: {},

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "liara-mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "MCP server for Liara cloud platform - deploy and manage apps, databases, and infrastructure",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
-    "liara-mcp": "./dist/index.js"
+    "liara-mcp": "./dist/index.js",
+    "liara-mcp-setup": "./bin/setup.js"
   },
   "files": [
     "dist",
+    "bin",
     "README.md",
     "LICENSE"
   ],