التثبيت#

يلزم Node.js 20+. واجهة المنصة نفسها تتطلب Node.js 18+.

من npm #

npm install -g tgcloud-mcptgcloud-mcp setup

المعالج يكتب إعداد MCP ويسأل إن كنت تريد تثبيت Agent Plugin (المجلد agent-plugin/ في المستودع). النسخة توضع في ~/.tgcloud-mcp/agent-plugin. يحصل Cursor على ~/.cursor/plugins/local/tgcloud. يحصل VS Code على مدخل في chat.pluginLocations. يحمّل Codex وCopilot وKiro المجلد نفسه من واجهة الإضافات.

يبقى Claude Code وopencode على إعداد MCP. أضف المهارة هكذا:

npx skills add sdamarketing/tgcloud_mcp

أمر واحد #

curl -fsSL https://raw.githubusercontent.com/sdamarketing/tgcloud_mcp/main/install.sh | bash

ينسخ المستودع إلى ~/.tgcloud-mcp، يبني، ثم يشغّل المعالج. إعادة التشغيل تُحدّث. يسأل أولًا عن اللغة (English وРусский و中文 والعربية وDeutsch وFrançais؛ Enter تعني الإنجليزية، أو عيّن TGCLOUD_MCP_LANG). ثم يعرض شعارًا داخل إطار (تدرّج أزرق في طرفية truecolor) ومؤشر دوران أثناء النسخ والتثبيت والبناء. المعالج يتابع باللغة نفسها ويقرأ /dev/tty، لذلك يسأل حتى مع curl | bash.

Docker #

docker run -i --rm ghcr.io/sdamarketing/tgcloud-mcp

إعداد يدوي #

opencode (~/.config/opencode/opencode.json):

{ "mcp": { "tgcloud": { "type": "local", "command": ["npx", "-y", "tgcloud-mcp"], "enabled": true } } }

Claude Code / Cursor:

{ "mcpServers": { "tgcloud": { "command": "npx", "args": ["-y", "tgcloud-mcp"] } } }

VS Code (mcp.json):

{ "servers": { "tgcloud": { "type": "stdio", "command": "npx", "args": ["-y", "tgcloud-mcp"] } } }

متغيرات البيئة#