Skip to content

Commit 8fa6dd7

Browse files
its-mashits-mash
committed
fix: add one-click IDE install for VS Code and Cursor
Add ConnectIDEs component with one-click buttons to add mcpmux as an MCP server to VS Code and Cursor via deep links. Replaces the manual copy-paste config card on the dashboard. - Add client_install service in mcpmux-core (deep link URL generation) - Add Tauri commands: add_to_vscode, add_to_cursor - Add ConnectIDEs React component with install status tracking - Add TypeScript and component tests - Set MCP server title to "McpMux" in Implementation info Signed-off-by: Myko <myko@mcpmux.com> Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
1 parent 2d99f14 commit 8fa6dd7

15 files changed

Lines changed: 587 additions & 67 deletions

File tree

‎Cargo.lock‎

Lines changed: 7 additions & 7 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎apps/desktop/src-tauri/src/commands/client_install.rs‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
//! One-click IDE install commands.
2+
//!
3+
//! Opens deep link URIs for VS Code and Cursor to install the McpMux MCP server.
4+
5+
use mcpmux_core::{cursor_deep_link, vscode_deep_link};
6+
use tracing::info;
7+
8+
/// Add McpMux to VS Code via deep link.
9+
#[tauri::command]
10+
pub async fn add_to_vscode(gateway_url: String) -> Result<(), String> {
11+
let uri = vscode_deep_link(&gateway_url);
12+
info!("[ClientInstall] Opening VS Code deep link: {}", uri);
13+
open_deep_link(&uri)
14+
}
15+
16+
/// Add McpMux to Cursor via deep link.
17+
#[tauri::command]
18+
pub async fn add_to_cursor(gateway_url: String) -> Result<(), String> {
19+
let uri = cursor_deep_link(&gateway_url);
20+
info!("[ClientInstall] Opening Cursor deep link: {}", uri);
21+
open_deep_link(&uri)
22+
}
23+
24+
/// Open a deep link URI using the system handler.
25+
fn open_deep_link(uri: &str) -> Result<(), String> {
26+
#[cfg(target_os = "windows")]
27+
{
28+
open_url_shell_execute(uri)
29+
}
30+
#[cfg(not(target_os = "windows"))]
31+
{
32+
open::that(uri).map_err(|e| format!("Failed to open URI: {}", e))
33+
}
34+
}
35+
36+
/// Windows: Use ShellExecuteW to open URI without flashing a console window.
37+
#[cfg(target_os = "windows")]
38+
fn open_url_shell_execute(url: &str) -> Result<(), String> {
39+
use std::ffi::OsStr;
40+
use std::os::windows::ffi::OsStrExt;
41+
use std::ptr;
42+
43+
#[link(name = "shell32")]
44+
extern "system" {
45+
fn ShellExecuteW(
46+
hwnd: *mut std::ffi::c_void,
47+
operation: *const u16,
48+
file: *const u16,
49+
parameters: *const u16,
50+
directory: *const u16,
51+
show_cmd: i32,
52+
) -> isize;
53+
}
54+
55+
let url_wide: Vec<u16> = OsStr::new(url).encode_wide().chain(Some(0)).collect();
56+
let open_wide: Vec<u16> = OsStr::new("open").encode_wide().chain(Some(0)).collect();
57+
58+
let result = unsafe {
59+
ShellExecuteW(
60+
ptr::null_mut(),
61+
open_wide.as_ptr(),
62+
url_wide.as_ptr(),
63+
ptr::null(),
64+
ptr::null(),
65+
1, // SW_SHOWNORMAL
66+
)
67+
};
68+
69+
if result > 32 {
70+
Ok(())
71+
} else {
72+
Err(format!("ShellExecuteW failed with code: {}", result))
73+
}
74+
}

‎apps/desktop/src-tauri/src/commands/mod.rs‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
66
pub mod client;
77
pub mod client_custom_features;
8+
pub mod client_install;
89
pub mod config_export;
910
pub mod credential;
1011
pub mod feature_members;
@@ -22,6 +23,7 @@ pub mod space;
2223
// Re-export commands for convenience
2324
pub use client::*;
2425
pub use client_custom_features::*;
26+
pub use client_install::*;
2527
pub use config_export::*;
2628
pub use feature_members::*;
2729
pub use feature_set::*;

‎apps/desktop/src-tauri/src/lib.rs‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -760,6 +760,9 @@ pub fn run() {
760760
commands::get_config_paths,
761761
commands::check_config_exists,
762762
commands::backup_existing_config,
763+
// Client install commands (one-click IDE setup)
764+
commands::add_to_vscode,
765+
commands::add_to_cursor,
763766
// Gateway commands
764767
commands::get_gateway_status,
765768
commands::start_gateway,

‎apps/desktop/src/App.tsx‎

Lines changed: 6 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ import {
88
Settings,
99
Sun,
1010
Moon,
11-
Check,
1211
Loader2,
1312
FolderOpen,
1413
FileText,
@@ -29,6 +28,7 @@ import { ThemeProvider } from '@/components/ThemeProvider';
2928
import { OAuthConsentModal } from '@/components/OAuthConsentModal';
3029
import { ServerInstallModal } from '@/components/ServerInstallModal';
3130
import { SpaceSwitcher } from '@/components/SpaceSwitcher';
31+
import { ConnectIDEs } from '@/components/ConnectIDEs';
3232
import { useDataSync } from '@/hooks/useDataSync';
3333
import { useAppStore, useActiveSpace, useViewSpace, useTheme } from '@/stores';
3434
import { RegistryPage } from '@/features/registry';
@@ -270,7 +270,6 @@ function DashboardView() {
270270
running: boolean;
271271
url: string | null;
272272
}>({ running: false, url: null });
273-
const [exportSuccess, setExportSuccess] = useState<string | null>(null);
274273
const viewSpace = useViewSpace();
275274

276275
// Load stats on mount and when gateway changes
@@ -438,61 +437,11 @@ function DashboardView() {
438437
</Card>
439438
</div>
440439

441-
{/* Client Config */}
442-
<Card>
443-
<CardHeader>
444-
<CardTitle>Connect Your Client</CardTitle>
445-
<CardDescription>
446-
Add this server configuration to your MCP client settings (e.g., inside mcpServers section).
447-
</CardDescription>
448-
</CardHeader>
449-
<CardContent>
450-
<div className="space-y-4">
451-
{/* Gateway URL */}
452-
<div className="flex items-center gap-2 text-sm">
453-
<span className={`h-2 w-2 rounded-full ${gatewayStatus.running ? 'bg-green-500' : 'bg-orange-500'}`} />
454-
<span className="text-[rgb(var(--muted))]">Gateway:</span>
455-
<code className="bg-[var(--surface)] px-2 py-1 rounded text-primary-500">
456-
{gatewayStatus.url || 'http://localhost:3100'}
457-
</code>
458-
{!gatewayStatus.running && (
459-
<span className="text-orange-500 text-xs">(not running)</span>
460-
)}
461-
</div>
462-
463-
{/* Config Display */}
464-
<div className="relative">
465-
<pre className="bg-mcpmux-dark text-primary-100 p-4 rounded-lg text-sm overflow-x-auto font-mono">
466-
{`"mcpmux": {
467-
"type": "http",
468-
"url": "${gatewayStatus.url || 'http://localhost:3100'}/mcp"
469-
}`}
470-
</pre>
471-
<Button
472-
variant="secondary"
473-
size="sm"
474-
className="absolute top-2 right-2"
475-
onClick={async () => {
476-
const config = `"mcpmux": {\n "type": "http",\n "url": "${gatewayStatus.url || 'http://localhost:3100'}/mcp"\n}`;
477-
await navigator.clipboard.writeText(config);
478-
setExportSuccess('Config copied to clipboard!');
479-
setTimeout(() => setExportSuccess(null), 2000);
480-
}}
481-
data-testid="copy-config-btn"
482-
>
483-
📋 Copy
484-
</Button>
485-
</div>
486-
487-
{exportSuccess && (
488-
<div className="text-sm text-green-600 dark:text-green-400 flex items-center gap-1">
489-
<Check className="h-4 w-4" />
490-
{exportSuccess}
491-
</div>
492-
)}
493-
</div>
494-
</CardContent>
495-
</Card>
440+
{/* Connect IDEs — one-click install */}
441+
<ConnectIDEs
442+
gatewayUrl={gatewayStatus.url || 'http://localhost:3100'}
443+
gatewayRunning={gatewayStatus.running}
444+
/>
496445
</div>
497446
);
498447
}

0 commit comments

Comments
 (0)