npm package: @mcp-registry/mcp-telegram-content-generator
Description: Professional MCP server for AI-powered Telegram communication - Perfect for students, educators, and researchers
Author: Falah.G.Salieh
Latest version: 1.0.3

# MCP Telegram Content Generator

A professional Model Context Protocol (MCP) server that leverages Claude LLM to generate and deliver high-quality content through Telegram. This tool specializes in automated content generation and distribution, making it ideal for content creators, educators, researchers, and professionals who need streamlined content delivery.

**Developer**: Falah.G.Salieh (Iraq) © 2025

## 🏷️ Keywords

`content-generation` `telegram-delivery` `claude-llm` `mcp-server` `automated-publishing` `node-js` `typescript` `article-generator` `content-distribution` `batch-processing` `docker` `content-automation` `telegram-integration` `professional-writing` `content-pipeline`

## 🎥 Demo

<div align="center">
  
![Demo](video/mcp-telegram-ai-assistant.gif)

  <h3>🎯 Key Features Demonstrated</h3>
  <table>
    <tr>
      <td>📝 Content Generation</td>
      <td>🌍 Multi-language Support</td>
    </tr>
    <tr>
      <td>🔄 Automated Delivery</td>
      <td>💾 Content Storage</td>
    </tr>
    <tr>
      <td>🎨 Professional Formatting</td>
      <td>📱 Telegram Integration</td>
    </tr>
  </table>
</div>

## 🌟 Key Features

- **Automated Content Generation**: Powered by Claude LLM for high-quality content creation
- **Telegram Integration**: Direct content delivery through Telegram channels
- **Multi-language Support**: Generate content in multiple languages including RTL support
- **Content Storage**: All generated content is automatically archived
- **Professional Formatting**: Clean, well-formatted content delivery

## 🎯 Use Cases

### Content Creation
- Long-form articles
- Educational materials
- Research summaries
- Technical documentation
- Marketing content
- Training resources

### Distribution
- Telegram channels
- Educational groups
- Research communities
- Professional networks
- Content archives

## 🚀 Getting Started

### Prerequisites
- Node.js (v16 or higher)
- Telegram Bot Token (from @BotFather)
- Claude API Access

### Installation

1. Clone the repository:
```bash
git clone https://github.com/falahgs/mcp-telegram-content-generator.git
cd mcp-telegram-content-generator
```

2. Install dependencies:
```bash
npm install
```

3. Configure environment variables:
```env
TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHAT_ID=your_chat_id_here
CLAUDE_API_KEY=your_claude_api_key
```

4. Build and start:
```bash
npm run build
npm start
```

## 💡 Usage

The server provides two main functions:

1. `generate-content`:
```json
{
  "name": "generate-content",
  "arguments": {
    "topic": "Technology Trends 2025",
    "type": "article",
    "sendToTelegram": true
  }
}
```

2. `send-telegram`:
```json
{
  "name": "send-telegram",
  "arguments": {
    "content": "Generated content here",
    "parseMode": "Markdown"
  }
}
```

## 📁 Project Structure

```
mcp-telegram-content-generator/
├── src/
│   └── index.ts         # Main server code
├── dist/               # Compiled JavaScript
├── content/           # Generated content
├── .env               # Environment variables
└── package.json       # Project dependencies
```

## 🔧 Configuration

### Environment Variables
- `CLAUDE_API_KEY`: Your Claude API key
- `TELEGRAM_BOT_TOKEN`: Your Telegram bot token
- `TELEGRAM_CHAT_ID`: Your Telegram chat ID

## 🐳 Docker Support

```bash
# Build
docker build -t mcp-telegram-content-generator .

# Run
docker run -d \
  --name mcp-telegram-content \
  -p 3000:3000 \
  -v $(pwd)/content:/app/content \
  --env-file .env \
  mcp-telegram-content-generator
```

## 🔒 Security

- Secure API key storage
- Content backup
- Rate limiting
- Error handling

---
Developed with ❤️ by Falah.G.Salieh | Iraq © 2025