tgcloud-mcp 0.1.0 → 0.2.0

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 (2) hide show
  1. package/README.md +25 -6
  2. package/package.json +14 -4
package/README.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # tgcloud-mcp — MCP-сервер для Telegram serverless bots
2
2
 
3
+ [![CI](https://github.com/sdamarketing/tgcloud_mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/sdamarketing/tgcloud_mcp/actions/workflows/ci.yml)
4
+ [![npm](https://img.shields.io/npm/v/tgcloud-mcp?style=flat-square)](https://www.npmjs.com/package/tgcloud-mcp)
5
+ [![ghcr](https://img.shields.io/badge/ghcr-sdamarketing%2Ftgcloud--mcp-blue?style=flat-square)](https://github.com/sdamarketing/tgcloud_mcp/pkgs/container/tgcloud-mcp)
6
+
3
7
  Учит AI-ассистента управлять serverless-ботами Telegram ([core.telegram.org/bots/serverless](https://core.telegram.org/bots/serverless)):
4
8
  вы говорите ассистенту «создай бота», «задеплой», «покажи статус вебхука» — а он выполняет
5
9
  это через `tgcloud` CLI, не трогая терминал руками.
@@ -30,22 +34,37 @@
30
34
 
31
35
  ## Установка
32
36
 
33
- Требуется Node.js 20+ (самой платформе tgcloud достаточно 18+).
37
+ Требуется Node.js 20+ (CLI платформы tgcloud требует 18+).
38
+
39
+ **Из npm:**
34
40
 
35
41
  ```bash
36
42
  npm install -g tgcloud-mcp
43
+ tgcloud-mcp setup # мастер: настройка MCP-клиента
44
+ ```
45
+
46
+ **В одну команду (macOS / Linux / WSL)** — клон в `~/.tgcloud-mcp` + мастер:
47
+
48
+ ```bash
49
+ curl -fsSL https://raw.githubusercontent.com/sdamarketing/tgcloud_mcp/main/install.sh | bash
37
50
  ```
38
51
 
39
- или из исходников:
52
+ **Docker:**
40
53
 
41
54
  ```bash
42
- git clone <адрес-репозитория>
55
+ docker run -i --rm ghcr.io/sdamarketing/tgcloud-mcp
56
+ ```
57
+
58
+ **Из исходников:**
59
+
60
+ ```bash
61
+ git clone https://github.com/sdamarketing/tgcloud_mcp.git
43
62
  cd tgcloud_mcp
44
- npm install
45
- npm run build
46
- npm run smoke # проверка: "OK: server \"tgcloud\" v…, 14 tools, 5 resources listed"
63
+ npm install && npm test # build + smoke + e2e
47
64
  ```
48
65
 
66
+ Подробно (токены, клиенты, переменные, решение проблем) — **[docs/SETUP.md](docs/SETUP.md)**.
67
+
49
68
  ## Подключение к агенту
50
69
 
51
70
  Конфиг MCP-клиента (пример для opencode / Claude Code / Cursor — формат `mcpServers` одинаковый):
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tgcloud-mcp",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "MCP server for Telegram serverless bots (@tgcloud) — project lifecycle, deploys, migrations and webhooks through the tgcloud CLI",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -15,8 +15,12 @@
15
15
  "start": "node dist/index.js",
16
16
  "typecheck": "tsc --noEmit",
17
17
  "smoke": "node scripts/smoke-test.mjs",
18
- "test": "npm run build && npm run smoke",
19
- "prepublishOnly": "npm run build && npm run smoke"
18
+ "setup": "node scripts/setup.mjs",
19
+ "links": "node scripts/generate-install-links.mjs",
20
+ "docs:check": "node scripts/check-docs-drift.mjs",
21
+ "update": "node scripts/self-update.mjs",
22
+ "test": "npm run build && npm run smoke && node tests/e2e.mjs",
23
+ "prepublishOnly": "npm run test"
20
24
  },
21
25
  "dependencies": {
22
26
  "@modelcontextprotocol/server": "^2.1.0",
@@ -41,5 +45,11 @@
41
45
  "serverless",
42
46
  "tgcloud"
43
47
  ],
44
- "license": "MIT"
48
+ "license": "MIT",
49
+ "repository": {
50
+ "type": "git",
51
+ "url": "git+https://github.com/sdamarketing/tgcloud_mcp.git"
52
+ },
53
+ "homepage": "https://github.com/sdamarketing/tgcloud_mcp",
54
+ "bugs": "https://github.com/sdamarketing/tgcloud_mcp/issues"
45
55
  }