tggroupMCP

TypeScript MCP stdio server for a Telegram group through MTProto/GramJS.

The default chat is Парилка228 (-1003179772905), but all chat IDs live in env config so the server can be reused for other groups.

Setup

cd /root/telegram-parilka-mcp
npm install
cp .env.example .env
npm run generate-session
npm run build

Put the generated TELEGRAM_SESSION into .env.

Related MCP server: Telegram MCP Server

Run

npm run print-config
npm run start

Cache warmer

Run this as a long-lived process to keep SQLite warm. It fetches recent messages first, then an older backfill chunk, using cursors stored in SQLite:

npm run sync-daemon

One-shot mode, useful for cron/systemd timers:

npm run sync-once

Vector RAG

Set OPENAI_API_KEY or TELEGRAM_EMBEDDINGS_API_KEY, then index cached messages into local SQLite vector chunks:

npm run embed-once -- --limit-chunks 1000

The regular sync daemon also indexes new chunks when embeddings are configured. search_messages returns keyword, vector, and hybrid candidates; semantic_search_messages returns only cosine-ranked chunks.

MCP config example:

[mcp_servers.telegram-parilka]
command = "/root/telegram-parilka-mcp/bin/telegram-parilka-mcp"

Sending is live by default. Set TELEGRAM_SEND_ENABLED=false or pass dry_run: true to preview without posting.