✨ Key Changes:

• Dockerfile Added: A Dockerfile has been created using the python:3.13-alpine base image, ensuring minimal vulnerabilities and a lightweight build.
• Docker Compose Integration: A docker-compose.yml file has been included to enable simplified local development setups with support for .env configuration.
• GitHub Actions Workflow: A new GitHub Actions workflow (docker-build.yml) has been implemented to automate Docker image builds and validate docker-compose.yml configurations on push/pull requests to main.
• Docker Best Practices: Updates to the Dockerfile include secure configurations and base image pinning.

🚀 Usage Instructions:

• Build the image locally:

  docker build -t telegram-mcp:latest .

Summary

This pull request focuses on improving the stability and compatibility of the Telegram MCP server by removing tools that were either unreliable or incompatible with the expected MCP environment.

Changes Included

1. Removed File Handling Tools:

   • Removed tools relying on direct file_path arguments (send_file, download_media, set_profile_photo, edit_chat_photo, send_voice, send_sticker, upload_file).
   • Reason: These tools assumed direct file system access via absolute paths, which is not reliably supported by the MCP interaction model for attached files.

2. Removed GIF Handling Tools:

   • Removed get_gif_search, get_saved_gifs, and send_gif.
   • Reason: Despite attempts to refactor and fix (get_gif_search implementation updated, get_saved_gifs added, logging added to send_gif), these tools continued to exhibit unreliable behavior and errors, likely due to underlying library/API complexities or inconsistencies. They have been removed to ensure overall toolset stability.

3. Documentation Updates:

   • Updated README.md to remove references to the deleted file and GIF tools in the "Features & Tools" list.
   • Added notes to the "Removed Functionality" section in README.md explaining why these toolsets were removed.

Impact

• Reduces the number of available tools but increases the reliability of the remaining set.
• Aligns the toolset more closely with the practical limitations observed in the MCP environment.

Version 2.0 Release: Comprehensive Functionality Update

This major release brings significant improvements to the Telegram MCP integration, focusing on stability, error handling, and enhanced API functionality:

🔧 Core Functionality Fixes

• Fixed get_invite_link and export_chat_invite functions with multiple fallback mechanisms:

  • Added primary approach using ExportChatInviteRequest with peer parameter
  • Implemented secondary fallback to export_chat_invite_link
  • Added tertiary fallback to fetch chat info directly via GetFullChatRequest

• Enhanced chat joining functionality with better hash extraction and error handling:

  • Improved recognition of various Telegram invite link formats
  • Added intelligent handling of "already member" cases
  • Better error messaging for expired/invalid invites

• Improved message processing with more robust entity handling

  • Enhanced entity resolution for complex chat types
  • Better message context retrieval

🛡️ Robust Error Handling

• Implemented comprehensive error handling throughout all API functions
• Added detailed error logging with categorized error codes
• Enhanced session management supporting both file-based and string-based sessions
• Introduced graceful degradation for all critical functions
• Added user-friendly error messages instead of exposing technical exceptions

🚀 New & Enhanced Features

• Improved media handling capabilities
• Enhanced group management functions with better permissions handling
• Better contact management with more reliable search and interaction
• More powerful search capabilities across messages and chats
• Optimized performance for chat listing and message retrieval

📚 Project Improvements

• Reorganized codebase following Python best practices
• Enhanced test suite with comprehensive function coverage
• Updated documentation with real-world examples and screenshots
• Added security considerations and improved installation instructions

This release represents a significant step forward in stability, functionality, and user experience for the Telegram MCP integration, making it more reliable for production use.

Author: @l1v0n1 reviewed by @chigwell