1click cursor install (#5)

Author: araa47

README.md

@@ -10,13 +10,69 @@ A Python MCP (Model Context Protocol) server for the [Jupiter Ultra API](https:/
 - **Comprehensive Testing**: Safe testing with mock and real trade execution
 - **Type-Safe**: Full type annotations for Python
 
-## ⚡ Quick Start (MCP Configuration)
+## 📋 Prerequisites
 
 You need:
-- [uv](https://docs.astral.sh/uv/getting-started/installation/) -> Python dependency manager
-- [npx](https://docs.npmjs.com/cli/v10/commands/npx) (comes with Node.js) -> Used to run Node packages without installing them globally (temporarily used since cursor doesn't support )
+- [uv](https://docs.astral.sh/uv/getting-started/installation/) → Python dependency manager
+- [npx](https://docs.npmjs.com/cli/v10/commands/npx) (comes with Node.js) → Used to run envmcp for secure .env file loading
+
+Once uv is installed, restart your shell before proceeding.
+
+## 🚀 1-Click Install for Cursor
+
+### Option 1: Using .env File (Recommended - More Secure)
+
+<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=jupiter-ultra-mcp-env&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJlbnZtY3AiLCItLWVudi1maWxlIiwifi8uZW52IiwidXZ4IiwiLS1mcm9tIiwiZ2l0K2h0dHBzOi8vZ2l0aHViLmNvbS9hcmFhNDcvanVwaXRlci11bHRyYS1tY3AiLCJqdXBpdGVyLXVsdHJhLW1jcCJdfQ==">
+  <img src="https://img.shields.io/badge/Install%20with%20.env%20File-00AAFF?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJDNi40NzcgMiAyIDYuNDc3IDIgMTJDMiAxNy41MjMgNi40NzcgMjIgMTIgMjJDMTcuNTIzIDIyIDIyIDE3LjUyMyAyMiAxMkMyMiA2LjQ3NyAxNy41MjMgMiAxMiAyWiIgZmlsbD0id2hpdGUiLz4KPHBhdGggZD0iTTEwLjUgN0wxNC41IDE3SDE0TDEwIDE3VjEyTDkuNSA3SDEwLjVaIiBmaWxsPSIjMDBBQUZGIi8+Cjwvc3ZnPg==" alt="Install Jupiter Ultra MCP with .env file">
+</a>
+
+**Click the button above to install.** After installation, you'll need to update the env file path:
+
+1. **Create your `.env` file** at your preferred location (e.g., `~/.env`):
+```bash
+SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
+PRIVATE_KEY=your_base58_encoded_private_key_here
+SOLANA_NETWORK=mainnet-beta
+REQUEST_TIMEOUT=30
+```
+
+2. **Update the path in Cursor**:
+   - Go to **Tools & Integrations** section in Cursor
+   - Click on **MCP Tools**
+   - Find **jupiter-ultra-mcp-env**
+   - Hover near the on/off switch and click the **pencil icon** ✏️
+   - Replace `~/.env` with your actual env file path (e.g., `/Users/yourname/.env`)
+   - Click **Save**
 
-Once uv is installed, restart your shell and add this to your MCP client configuration:
+Or copy this link:
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=jupiter-ultra-mcp-env&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJlbnZtY3AiLCItLWVudi1maWxlIiwifi8uZW52IiwidXZ4IiwiLS1mcm9tIiwiZ2l0K2h0dHBzOi8vZ2l0aHViLmNvbS9hcmFhNDcvanVwaXRlci11bHRyYS1tY3AiLCJqdXBpdGVyLXVsdHJhLW1jcCJdfQ==
+```
+
+### Option 2: With Cursor Input Prompts (Less Secure)
+
+If you prefer to configure directly through Cursor prompts:
+
+<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=jupiter-ultra-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2FyYWE0Ny9qdXBpdGVyLXVsdHJhLW1jcCIsImp1cGl0ZXItdWx0cmEtbWNwIl0sImVudiI6eyJQUklWQVRFX0tFWSI6IlJFUExBQ0VfVEhJUyIsIlNPTEFOQV9SUENfVVJMIjoiaHR0cHM6Ly9hcGkubWFpbm5ldC1iZXRhLnNvbGFuYS5jb20iLCJTT0xBTkFfTkVUV09SSyI6Im1haW5uZXQtYmV0YSIsIlJFUVVFU1RfVElNRU9VVCI6IjMwIn19">
+  <img src="https://img.shields.io/badge/Install%20in%20Cursor-00AAFF?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJDNi40NzcgMiAyIDYuNDc3IDIgMTJDMiAxNy41MjMgNi40NzcgMjIgMTIgMjJDMTcuNTIzIDIyIDIyIDE3LjUyMyAyMiAxMkMyMiA2LjQ3NyAxNy41MjMgMiAxMiAyWiIgZmlsbD0id2hpdGUiLz4KPHBhdGggZD0iTTEwLjUgN0wxNC41IDE3SDE0TDEwIDE3VjEyTDkuNSA3SDEwLjVaIiBmaWxsPSIjMDBBQUZGIi8+Cjwvc3ZnPg==" alt="Install Jupiter Ultra MCP in Cursor">
+</a>
+
+**Click the button above to install.** You'll be prompted to replace `REPLACE_THIS` with your actual private key.
+
+Or copy this link:
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=jupiter-ultra-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2FyYWE0Ny9qdXBpdGVyLXVsdHJhLW1jcCIsImp1cGl0ZXItdWx0cmEtbWNwIl0sImVudiI6eyJQUklWQVRFX0tFWSI6IlJFUExBQ0VfVEhJUyIsIlNPTEFOQV9SUENfVVJMIjoiaHR0cHM6Ly9hcGkubWFpbm5ldC1iZXRhLnNvbGFuYS5jb20iLCJTT0xBTkFfTkVUV09SSyI6Im1haW5uZXQtYmV0YSIsIlJFUVVFU1RfVElNRU9VVCI6IjMwIn19
+```
+
+**Pre-configured values:**
+- `SOLANA_RPC_URL`: https://api.mainnet-beta.solana.com
+- `SOLANA_NETWORK`: mainnet-beta
+- `REQUEST_TIMEOUT`: 30 seconds
+- `PRIVATE_KEY`: You'll need to replace `REPLACE_THIS` with your base58 encoded private key
+
+## ⚡ Quick Start (MCP Configuration)
+
+Add this to your MCP client configuration:
 
 Cursor
 ```json
@@ -52,20 +108,21 @@ If you prefer to load environment variables from a `.env` file to avoid storing
       "args": [
         "envmcp",
         "--env-file",
-        ".env",
+        "${ENV_FILE_PATH}",
         "uvx",
         "--from",
         "git+https://github.com/araa47/jupiter-ultra-mcp",
-        "jupiter-ultra-mcp",
-        "$SOLANA_RPC_URL",
-        "$PRIVATE_KEY"
-      ]
+        "jupiter-ultra-mcp"
+      ],
+      "env": {
+        "ENV_FILE_PATH": ".env"
+      }
     }
   }
 }
 ```
 
-This approach uses `envmcp` to securely load your PRIVATE_KEY from a `.env` file without exposing it in configuration files.
+This approach uses `envmcp` to securely load your PRIVATE_KEY from a `.env` file without exposing it in configuration files. Replace `ENV_FILE_PATH` with the absolute path to your `.env` file (e.g., `/Users/yourname/.env` or `/home/user/.env`).
 
 ### Environment Variables Required:
 - `PRIVATE_KEY`: Your base58 encoded Solana private key (from Phantom wallet export)