remote-access-mcp 1.0.4 → 1.0.6

package/README.fa.md

@@ -0,0 +1,114 @@
+# remote-access-mcp
+
+[![npm version](https://img.shields.io/npm/v/remote-access-mcp.svg)](https://www.npmjs.com/package/remote-access-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+هر سرور لینوکسی رو با MCP ([Model Context Protocol](https://modelcontextprotocol.io)) به ماشینی تبدیل کن که هوش مصنوعی بهش وصل بشه.
+
+ChatGPT (حالت Developer)، Claude، Grok و هر کلاینت MCP-دیگه از طریق HTTPS وصل میشن و به‌صورت امن سرورت رو کنترل می‌کنن: خواندن و نوشتن فایل، اجرای دستورات شل، وضعیت سیستم، دیتابیس SQLite و کار با گیت — همه پشت یک توکن.
+
+**بدون پایتون. بدون داکر. فقط Node.js.**
+
+```bash
+npm install -g remote-access-mcp
+ramcp init
+```
+
+## فلسفه
+
+دستیارهای هوش مصنوعی قوی‌ان ولی از زیرساخت شما دورن. این گیت‌وی اون رو برعکس می‌کنه: چت‌بات شما خودش مهندس DevOps میشه. «ببین چرا دیسک سرور پر میشه» یا «برنچ جدید رو دیپلوی کن و لاگ‌ها رو نگاه کن» تبدیل به گفتگوهای واقعی میشن.
+
+سرور فقط روی `127.0.0.1` گوش میده. پشت nginx/Caddy (با Cloudflare یا هر لبه TLS دیگه) قرارش میدی و دقیقاً یک endpoint HTTPS به دنیا ارائه میشه. هر درخواست باید توکن داشته باشه — یا به‌صورت هدر `Authorization: Bearer` یا داخل مسیر URL (`/<token>/mcp`) برای کلاینت‌هایی مثل کانکتور ChatGPT که نمی‌تونن هدر سفارشی ست کنن.
+
+## نصب
+
+### یک خطی (هر سرور اوبونتو/دبیان)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/AmirAliManzar/remote-access-mcp/main/install.sh | bash
+```
+
+سپس:
+
+```bash
+ramcp init
+```
+
+### دستی
+
+```bash
+npm install -g remote-access-mcp
+ramcp init
+```
+
+## دستورات
+
+| دستور | توضیح |
+|---|---|
+| `ramcp init` | ساخت کانفیگ + توکن. اجرای مجدد امنه. |
+| `ramcp start` | اجرا در foreground. |
+| `ramcp url` | چاپ URL کانکتور برای چت‌بات. |
+| `ramcp token rotate` | تولید توکن جدید (قبلی فوراً باطل میشه). |
+| `ramcp policy` | نمایش مسیرهای مجاز. |
+| `ramcp policy allow <path>` | دادن دسترسی AI به یک دایرکتوری. |
+| `ramcp policy deny <path>` | سلب دسترسی از یک دایرکتوری. |
+| `ramcp policy shell on/off` | فعال/غیرفعال کردن اجرای شل. |
+| `ramcp service install` | نصب سرویس systemd + vhostnginx. |
+| `ramcp service uninstall` | حذف سرویس و کانفیگ nginx. |
+| `ramcp status` | وضعیت سرویس. |
+
+## اتصال چت‌بات
+
+### ChatGPT (Developer Mode → Connectors)
+
+از فرمت URL استفاده کن (ChatGPT نمی‌تونه هدر سفارشی ست کنه):
+
+```
+https://دامنه.com/<token>/mcp
+```
+
+آماده‌ش رو بگیر:
+
+```bash
+$ ramcp url
+https://mcp.example.com/6kX9mQf2.../mcp
+```
+
+### Claude و هر کلاینت MCP با پشتیبانی هدر
+
+Endpoint: `https://دامنه.com/mcp`
+هدر: `Authorization: Bearer <token>`
+
+## ابزارها
+
+**فایل‌سیستم** (۷) — `list_directory`, `read_file`, `write_file`, `edit_file`, `delete_path`, `search_code`, `file_info`
+
+**شل** (۳) — `run_command`, `process_list`, `kill_process`
+
+**سیستم** (۳) — `system_info`, `disk_usage`, `network_interfaces`
+
+**HTTP** (۲) — `http_request`, `port_check`
+
+**گیت** (۱) — `git`
+
+**SQLite** (۲) — `sqlite_query`, `sqlite_schema`
+
+**سیاست دسترسی** (۴) — `list_allowed_paths`, `allow_path`, `deny_path`, `shell_enabled`
+
+## مدل امنیتی
+
+- **فقط loopback.** گیت‌وی روی `127.0.0.1:8765` گوش میده — از شبکه مستقیم قابل دسترسی نیست.
+- **احراز هویت توکنی روی هر درخواست.** دو فرمت: هدر bearer یا مسیر URL.
+- **موتور سیاست مسیر.** ابزارهای فایل‌سیستم symlinkها رو resolve و `..` رو قبل از چک allow/deny نرمال‌سازی می‌کنن. deny همیشه برنده‌ست.
+- **شل پشت فلگ.** تا صریحاً فعالش نکنی خاموشه.
+- **بدون لو رفتن رازها در لاگ‌ها.**
+
+انتظار اینه که TLS جلوش باشه (nginx + Let's Encrypt یا لبه CDN). خود گیت‌وی HTTP ساده روی loopback حرف می‌زنه.
+
+## مجوز
+
+MIT — [LICENSE](LICENSE)
+
+---
+
+📚 [English README](README.md) | [نقشه راه](ROADMAP.md)

package/README.md

@@ -1,5 +1,8 @@
 # remote-access-mcp
 
+[![npm version](https://img.shields.io/npm/v/remote-access-mcp.svg)](https://www.npmjs.com/package/remote-access-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Turn any Linux server into an AI-agent-accessible machine via the [Model Context Protocol](https://modelcontextprotocol.io) (MCP).
 
 ChatGPT (Developer Mode), Claude, Grok, and any MCP-compatible client connect over HTTPS and securely control your server: read/write files, run shell commands, inspect system state, query SQLite databases, work with git — all behind a single bearer token.
@@ -22,7 +25,7 @@ The server binds to `127.0.0.1` only. You put it behind nginx/Caddy (with Cloudf
 ### One-liner (any Ubuntu/Debian server)
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/amiralimanzar/remote-access-mcp/main/install.sh | bash
+curl -fsSL https://raw.githubusercontent.com/AmirAliManzar/remote-access-mcp/main/install.sh | bash
 ```
 
 Installs Node.js (if missing) via NodeSource, then the package globally. Then run:
@@ -139,3 +142,7 @@ It can, and on a dedicated server that's often simplest — the tools need broad
 ## License
 
 MIT — see [LICENSE](LICENSE).
+
+---
+
+📚 [README فارسی](README.fa.md) | [Roadmap](ROADMAP.md)

package/install.sh

@@ -2,7 +2,7 @@
 #
 # remote-access-mcp — one-liner installer for Ubuntu/Debian servers.
 #
-#   curl -fsSL https://raw.githubusercontent.com/amiralimanzar/remote-access-mcp/main/install.sh | bash
+#   curl -fsSL https://raw.githubusercontent.com/AmirAliManzar/remote-access-mcp/main/install.sh | bash
 #
 # What it does:
 #   1. Checks for Node.js >= 18. Installs it via NodeSource if missing.
@@ -76,4 +76,4 @@ printf '  1. ramcp init               # generate config + token\n'
 printf '  2. ramcp start              # run in foreground\n'
 printf '  3. ramcp service install    # systemd + nginx vhost (production)\n'
 printf '  4. ramcp url                # connector URL for your chatbot\n'
-printf '\nDocs: https://github.com/amiralimanzar/remote-access-mcp\n'
+printf '\nDocs: https://github.com/AmirAliManzar/remote-access-mcp\n'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-access-mcp",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Turn any Linux server into an AI-agent-accessible machine via MCP. ChatGPT, Claude, and Grok connect over HTTPS and control files, shell, git, and more — securely and with zero Python dependencies.",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
   "files": [
     "dist",
     "README.md",
+    "README.fa.md",
     "LICENSE",
     "install.sh"
   ],
@@ -36,16 +37,16 @@
     "claude",
     "devops"
   ],
-  "author": "Ali Manzar <amiralimanzar@gmail.com> (https://amiralimanzar.ir)",
+  "author": "Amir Ali Manzar (https://amiralimanzar.ir)",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/amiralimanzar/remote-access-mcp.git"
+    "url": "git+https://github.com/AmirAliManzar/remote-access-mcp.git"
   },
   "bugs": {
-    "url": "https://github.com/amiralimanzar/remote-access-mcp/issues"
+    "url": "https://github.com/AmirAliManzar/remote-access-mcp/issues"
   },
-  "homepage": "https://github.com/amiralimanzar/remote-access-mcp#readme",
+  "homepage": "https://github.com/AmirAliManzar/remote-access-mcp#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.20.0",
     "express": "^4.21.0",