mobilecoder-mcp 2.2.0 → 2.2.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 (4) hide show
  1. package/README.md +58 -94
  2. package/dist/agent.js +1 -1
  3. package/dist/cli.js +1 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -1,117 +1,81 @@
1
- # 🔐 MobileCoder ZK-Relay Agent (v2.2.0)
1
+ # 🦁 MobileCoder ZK-Relay Agent
2
+ Your Localhost, Everywhere. Securely bridge your mobile device to your desktop IDE (Cursor, VS Code, Terminal) via a Zero-Knowledge Encrypted Relay.
2
3
 
3
- > **Zero-Knowledge. Zero-Trust. Total Connectivity.**
4
- > Securely bridge your mobile device to your desktop IDE (Cursor, Windsurf, VSCode) with military-grade encryption.
4
+ <p align="center"> <img src="https://via.placeholder.com/800x400.png?text=Add+Your+Terminal+Screenshot+Here" alt="MobileCoder Terminal Interface" width="100%">
5
5
 
6
- [![npm version](https://img.shields.io/npm/v/mobilecoder-mcp.svg)](https://www.npmjs.com/package/mobilecoder-mcp)
7
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
8
- [![Security: ZK-Relay](https://img.shields.io/badge/Security-Zero--Knowledge-green.svg)]()
9
6
 
10
- ---
7
+ <em>Connect to your dev environment in <200ms with military-grade encryption.</em> </p>
11
8
 
12
- ## ⚡ Why ZK-Relay?
9
+ ⚡ Why ZK-Relay?
10
+ Traditional WebRTC connections are often blocked by corporate firewalls, university networks (Eduroam), and strict NATs. Cloud IDEs, on the other hand, require you to upload your code to their servers.
13
11
 
14
- The MobileCoder ZK-Relay architecture replaces traditional WebRTC to ensure **100% connectivity** even behind strict corporate firewalls and complex NATs, without compromising on privacy.
12
+ MobileCoder v2 introduces the ZK-Relay Protocol: A custom, lightweight, TCP-based tunneling architecture that ensures 100% connectivity without compromising privacy.
15
13
 
16
- - **Zero-Trust Relay**: The server only acts as a blind mailbox. It cannot see, decrypt, or store your data.
17
- - **End-to-End Encryption**: Every message is encrypted on your device and decrypted on your mobile (AES-256-CBC).
18
- - **Universal Bypass**: No more "ICE Connection Failed". If you have internet, you have a connection.
14
+ 🛡️ Zero-Trust Architecture: Our relay server acts as a "Blind Mailbox". It blindly forwards encrypted packets without ever having the keys to decrypt them.
19
15
 
20
- ---
16
+ 🔐 End-to-End Encryption: Your data is encrypted locally using AES-256-CBC and only decrypted on your mobile device.
21
17
 
22
- ## 🛡️ Security Features
18
+ 🌍 Universal Bypass: Works behind strict firewalls, VPNs, and 4G/5G networks where P2P fails.
23
19
 
24
- We've hardened version 2.1.x with advanced cryptographic protocols:
20
+ 🧠 Context Aware: The agent intelligently detects your environment (VS Code, Cursor, zsh, powershell) and adapts the mobile UI accordingly.
25
21
 
26
- - **🔐 PBKDF2 Key Derivation**: Your 6-digit pairing code is strengthened using PBKDF2-SHA256 with **1,000 iterations** to derive a master encryption key.
27
- - **🔄 Perfect Forward Secrecy (PFS)**: Session keys are automatically rotated every **10 minutes**. Even if one key is compromised, your past sessions remain secure.
28
- - **🛡️ Replay Attack Prevention**: Every message includes a unique **nonce (IV)** and a **timestamp**. Expired or duplicate messages are rejected.
29
- - **☁️ Ephemeral Sessions**: No data ever touches a disk. All communication is held in memory and destroyed immediately after the session ends.
22
+ 🛠️ Quick Start
23
+ No complex installation or config files required. Just use npx.
30
24
 
31
- ---
25
+ 1. Start the Agent (Desktop)
26
+ Open your terminal (inside VS Code, Cursor, or standalone) and run:
32
27
 
33
- ## 🚀 Installation
34
-
35
- ### Using npx (Recommended)
36
- No installation required. Run the latest version directly:
37
28
  ```bash
38
29
  npx mobilecoder-mcp@latest init
39
30
  ```
40
31
 
41
- ### Global Install
42
- ```bash
43
- npm install -g mobilecoder-mcp@latest
44
- ```
45
-
46
- ---
47
-
48
- ## 🛠️ Quick Start
49
-
50
- ### 1. Initialize
51
- Run the agent in your project directory:
52
- ```bash
53
- mobilecoder-mcp init
32
+ This will:
33
+ - Generate a cryptographically secure 6-digit pairing code.
34
+ - Derive a session key using PBKDF2-SHA256.
35
+ - Establish a secure WebSocket tunnel to the Relay Network.
36
+
37
+ 2. Connect (Mobile)
38
+ - Open [mobilecoder.xyz](https://mobilecoder.xyz) on your phone.
39
+ - Enter the 6-digit code displayed on your terminal.
40
+ - Done. You are now connected to your localhost.
41
+
42
+ 🏗️ Architecture & Security
43
+ We take security seriously. Here is the cryptographic flow of a MobileCoder session:
44
+
45
+ ```mermaid
46
+ graph LR
47
+ A[Desktop Agent] -->|AES-256 Encrypted| B(Blind Relay Server)
48
+ B -->|Forwarded Packet| C[Mobile Client]
49
+
50
+ style A fill:#d4f1f9,stroke:#333,stroke-width:2px
51
+ style B fill:#f9f2f4,stroke:#333,stroke-width:2px,stroke-dasharray: 5 5
52
+ style C fill:#d4f1f9,stroke:#333,stroke-width:2px
54
53
  ```
55
- This command will:
56
- - Generate a secure 6-digit session code.
57
- - Start the encrypted relay client.
58
- - Automatically detect and optimize for your IDE (**Cursor**, **Windsurf**, or **VSCode**).
59
-
60
- ### 2. Connect
61
- Visit [mobilecoder.xyz](https://mobilecoder.xyz) on your mobile device and enter the 6-digit code.
62
-
63
- ### 3. Build from Anywhere
64
- Use your mobile phone to:
65
- - ✍️ Write and edit code with AI assistance.
66
- - 🐚 Execute terminal commands.
67
- - 📂 Browse project files.
68
- - 🚀 Deploy applications.
69
-
70
- ---
71
-
72
- ## ⌨️ CLI Commands
73
-
74
- | Command | Description |
75
- |---------|-------------|
76
- | `init` | Start a new secure session with a fresh 6-digit code. |
77
- | `start --code=XXXXXX` | Resume a session with a specific code. |
78
- | `--debug` | Enable detailed JSON-RPC and Relay logging. |
79
- | `--signaling <url>` | Use a custom signaling/relay server. |
80
-
81
- ---
82
-
83
- ## 🏗️ Architecture
84
-
85
- ```text
86
- [Desktop IDE] <---> [ZK-Relay Agent] <--- Encrypted Channel (AES-256) ---> [Mobile Client]
87
- | |
88
- +----------- [ Blind Relay Server ] -----------------+
89
- (Blindly relays encrypted packets)
90
- ```
91
-
92
- 1. **Handshake**: Devices perform a PBKDF2-based key exchange.
93
- 2. **Encryption**: Desktop encrypts data locally with a 256-bit key.
94
- 3. **Relay**: Encrypted packets flow through our high-speed relay server.
95
- 4. **Decryption**: Mobile client decrypts data using the same derived key.
96
-
97
- ---
98
-
99
- ## 🤝 Contributing
100
54
 
101
- We welcome security audits and features!
102
- 1. Fork the repo.
103
- 2. Create your branch: `git checkout -b feat/secure-terminal`.
104
- 3. Commit changes: `git commit -m 'Add biometric auth'`.
105
- 4. Push to branch: `git push origin feat/secure-terminal`.
55
+ 🔐 The Crypto Stack
56
+ - **Key Derivation**: The 6-digit OTP is strengthened using PBKDF2 (Password-Based Key Derivation Function 2) with HMAC-SHA256 and **1,000 iterations** (synced with mobile for performance & sync).
57
+ - **Encryption Standard**: All data streams are encrypted using AES-256-CBC (Cipher Block Chaining).
58
+ - **Replay Protection**: Each packet includes a unique Nonce (IV) and a timestamp to prevent replay attacks.
59
+ - **Ephemeral Sessions**: No data is ever written to disk. Keys exist only in RAM and are destroyed when the session ends.
60
+
61
+ 📱 Features
62
+ - **Remote Terminal**: Full TTY support with color output and interactive input.
63
+ - **File Explorer**: Browse, read, and manage project files remotely.
64
+ - **IDE Integration**: Automatically detects if you are running inside Cursor or VS Code and adjusts the mobile badge.
65
+ - **Smart Commands**: Run pre-defined scripts (git status, docker ps) with one tap.
66
+
67
+ 🤝 Contributing
68
+ MobileCoder is built by developers, for developers. We welcome contributions!
69
+ 1. Fork the repository.
70
+ 2. Create your feature branch (`git checkout -b feature/amazing-feature`).
71
+ 3. Commit your changes (`git commit -m 'Add some amazing feature'`).
72
+ 4. Push to the branch (`git push origin feature/amazing-feature`).
106
73
  5. Open a Pull Request.
107
74
 
108
- ---
75
+ 📄 License
76
+ Distributed under the MIT License. See LICENSE for more information.
109
77
 
110
- ## 📄 License & Support
78
+ <p align="center"> <strong>Built with 💙 by Indie Developers. Powered by ZK-Relay.</strong>
111
79
 
112
- - **License**: MIT
113
- - **Issues**: [GitHub Issues](https://github.com/hasmetdurak/mobilecoder-mcp/issues)
114
- - **Website**: [mobilecoder.xyz](https://mobilecoder.xyz)
115
80
 
116
- ---
117
- **Version**: 2.2.0 | **Author**: @hasmetdurak | **Built for the Future of Mobile Coding.**
81
+ <a href="https://mobilecoder.xyz">Website</a> • <a href="https://github.com/hasmetdurak/mobilecoder-mcp">GitHub</a> </p>
package/dist/agent.js CHANGED
@@ -90,7 +90,7 @@ class ZKRelayAgent {
90
90
  reconnection: true,
91
91
  auth: {
92
92
  token: "AGENT_V2",
93
- version: "2.2.0"
93
+ version: "2.2.1"
94
94
  }
95
95
  });
96
96
  this.socket.on('connect', () => {
package/dist/cli.js CHANGED
@@ -11,7 +11,7 @@ const program = new commander_1.Command();
11
11
  program
12
12
  .name('mobilecoder-mcp')
13
13
  .description('MobileCoder Desktop Agent - ZK-Relay Edition')
14
- .version('2.2.0');
14
+ .version('2.2.1');
15
15
  program
16
16
  .command('init')
17
17
  .description('Start the secure relay agent')
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mobilecoder-mcp",
3
- "version": "2.2.0",
3
+ "version": "2.2.1",
4
4
  "description": "Secure Zero-Knowledge Terminal Relay for MobileCoder",
5
5
  "type": "commonjs",
6
6
  "main": "dist/agent.js",