Máy chủ MCP Telegram

Máy chủ MCP “Telegram” làm gì?

Máy chủ MCP Telegram tích hợp các khả năng mạnh mẽ của nền tảng nhắn tin Telegram với Model Context Protocol (MCP), cho phép các trợ lý AI và khách hàng tương tác lập trình với Telegram. Bằng cách sử dụng thư viện Telethon, máy chủ này cho phép tự động hóa toàn diện và quản lý các cuộc trò chuyện, tin nhắn, nhóm cũng như tương tác người dùng trong Telegram. Nó đóng vai trò cầu nối giữa các agent AI và API của Telegram, giúp thực hiện các tác vụ như gửi tin nhắn, truy xuất lịch sử trò chuyện, quản lý nhóm và nhiều hơn nữa. Điều này nâng cao đáng kể quy trình phát triển bằng cách tối ưu hóa giao tiếp, hỗ trợ phản hồi tự động và cung cấp công cụ truy vấn hoặc chỉnh sửa dữ liệu Telegram trực tiếp từ các công cụ AI như Claude, Cursor và các khách hàng tương thích MCP khác.

Danh sách Prompt

Không có mẫu prompt nào được liệt kê trong tài liệu hoặc các tệp của kho lưu trữ.

Danh sách Resource

Không có tài nguyên MCP nguyên thủy nào được tài liệu rõ ràng hoặc liệt kê trong các tệp hoặc README hiện có.

Danh sách Công cụ

• get_chats(page, page_size): Trả về danh sách các cuộc trò chuyện và nhóm Telegram được phân trang mà người dùng xác thực có quyền truy cập. Điều này cho phép khách hàng và các LLM liệt kê và lựa chọn từ lịch sử trò chuyện của người dùng để phân tích hoặc nhắn tin tiếp theo.

Tài liệu nêu rằng “Mọi tính năng lớn của Telegram/Telethon đều có sẵn như một công cụ,” nhưng chỉ có get_chats được đề cập rõ ràng. Danh sách đầy đủ các công cụ không được cung cấp trong tài liệu hiện có.

Trường hợp sử dụng của Máy chủ MCP này

• Nhắn tin tự động: Các agent AI có thể gửi tin nhắn, media hoặc tệp cho cá nhân hoặc nhóm trên Telegram, hỗ trợ thông báo tự động, phản hồi hoặc phát sóng thông tin.
• Phân tích trò chuyện: Truy xuất và phân tích lịch sử trò chuyện để tóm tắt thảo luận, trích xuất các nhiệm vụ hành động hoặc phân tích cảm xúc trong nhóm hoặc cuộc trò chuyện riêng tư trên Telegram.
• Quản lý nhóm: Quản lý thành viên, vai trò và quyền trong nhóm một cách lập trình để hỗ trợ quản trị cộng đồng hoặc đội nhóm hiệu quả.
• Tích hợp bot: Sử dụng máy chủ để vận hành các bot Telegram thực hiện quy trình phức tạp, chuyển tiếp thông tin hoặc đóng vai trò trợ lý ảo mạnh mẽ dựa trên AI.
• Trích xuất dữ liệu liền mạch: Trích xuất tin nhắn, tệp hoặc chi tiết cuộc trò chuyện cụ thể để tích hợp với hệ thống, bảng điều khiển hoặc cơ sở dữ liệu bên ngoài, hỗ trợ tự động hóa nâng cao.

Hướng dẫn thiết lập

Windsurf

1. Yêu cầu: Đảm bảo Node.js đã được cài đặt và Windsurf đã được cấu hình.
2. Tìm tệp cấu hình: Mở tệp cài đặt hoặc cấu hình của Windsurf.
3. Thêm Máy chủ MCP: Thêm máy chủ MCP Telegram vào mục mcpServers:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Lưu & Khởi động lại: Lưu cấu hình và khởi động lại Windsurf.
5. Xác minh thiết lập: Kiểm tra bảng điều khiển hoặc nhật ký của Windsurf để đảm bảo telegram-mcp đang chạy.

Bảo mật API Keys (ví dụ)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Claude

1. Yêu cầu: Đảm bảo Claude Desktop hoặc khách hàng tương thích Claude đã được cài đặt.
2. Tìm tệp cấu hình: Sửa tệp claude_desktop_config.json.
3. Thêm mục Máy chủ MCP:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Lưu & Khởi động lại: Lưu tệp JSON và khởi động lại Claude.
5. Xác minh: Xác nhận Claude nhận diện và kết nối với telegram-mcp.

Bảo mật API Keys (ví dụ)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cursor

1. Yêu cầu: Cài đặt Node.js và trình chỉnh sửa Cursor.
2. Mở cài đặt Cursor: Truy cập phần tích hợp MCP.
3. Thêm Máy chủ MCP Telegram:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Khởi động lại Cursor: Lưu cài đặt và khởi động lại ứng dụng Cursor.
5. Xác minh: Xác nhận Cursor nhận diện và kết nối với máy chủ MCP Telegram.

Bảo mật API Keys (ví dụ)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cline

1. Yêu cầu: Đảm bảo Cline đã được cài đặt và cấu hình.
2. Mở tệp cấu hình: Sửa tệp cài đặt hoặc cấu hình của Cline.
3. Thêm mục Máy chủ MCP:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Lưu & Khởi động lại: Lưu tệp và khởi động lại Cline.
5. Xác minh: Kiểm tra giao diện Cline để xác nhận máy chủ MCP Telegram đang chạy.

Bảo mật API Keys (ví dụ)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cách sử dụng MCP này trong luồng

Sử dụng MCP trong FlowHunt

Để tích hợp các máy chủ MCP vào luồng làm việc FlowHunt của bạn, bắt đầu bằng cách thêm thành phần MCP vào luồng và kết nối với agent AI của bạn:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình hệ thống MCP, hãy chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "telegram-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình xong, agent AI có thể sử dụng MCP này như một công cụ với đầy đủ các chức năng và khả năng của nó. Lưu ý đổi “telegram-mcp” thành tên thực tế của máy chủ MCP của bạn và thay URL bằng đường dẫn tới máy chủ MCP của bạn.

Tổng quan

Hỗ trợ roots: Không có nhắc tới
Hỗ trợ sampling: Không có nhắc tới

Tôi đánh giá Máy chủ MCP Telegram 6/10. Nó mạnh về chức năng, có hướng dẫn cài đặt và bảo mật rõ ràng, nhưng thiếu tài liệu về mẫu prompt, tài nguyên cụ thể và danh sách công cụ đầy đủ, đây là những yếu tố quan trọng cho tích hợp MCP nâng cao và minh bạch.

Điểm MCP