Quirox Telegram Bot Backend
by Himank-J
This project provides the backend services for the Quirox Telegram Bot, featuring an AI agent capable of interacting with various tools like Google Sheets, Gmail (currently commented out), and web search via DuckDuckGo. It uses the Model Context Protocol (MCP) to manage communication between the AI model (Google Gemini) and the available tools.
Last updated: N/A
What is Quirox Telegram Bot Backend?
The Quirox Telegram Bot Backend is a FastAPI-based server that provides backend services for a Telegram bot. It integrates an AI agent (Google Gemini) with tools like Google Sheets and DuckDuckGo for web search, enabling the bot to perform tasks and answer queries using these resources.
How to use Quirox Telegram Bot Backend?
To use the server, first clone the repository, install the dependencies, and configure the environment variables (including the Google Gemini API key and Google Cloud credentials). Then, run the MCP server and the FastAPI application concurrently. Interact with the AI agent by sending POST requests to the /chat endpoint with a JSON payload containing the user's message.
Key features of Quirox Telegram Bot Backend
AI Agent powered by Google Gemini
Integration with Google Sheets for data manipulation
Web search capabilities via DuckDuckGo
FastAPI web server for easy API interaction
Model Context Protocol (MCP) for managing communication between the AI model and tools
Use cases of Quirox Telegram Bot Backend
Creating and managing Google Sheets via Telegram commands
Searching the web for information and providing summaries to users
Automating tasks that require both AI reasoning and access to external tools
Building a conversational AI assistant with access to Google Sheets data
Integrating with other services through the AI agent and tool framework
FAQ from Quirox Telegram Bot Backend
What is the Model Context Protocol (MCP)?
What is the Model Context Protocol (MCP)?
MCP is a framework for managing communication between the AI model and the available tools, enabling the AI to use tools to answer questions and execute tasks.
What Google Cloud services are required?
What Google Cloud services are required?
The Google Sheets API and Google Drive API are required. The Gmail API is optional (currently commented out).
How do I authenticate with Google Cloud?
How do I authenticate with Google Cloud?
You can authenticate using either a Service Account (recommended for servers) or OAuth 2.0. Instructions for both methods are provided in the README.
Why is Gmail functionality commented out?
Why is Gmail functionality commented out?
The Gmail functionality is present in the code but appears to be disabled in the mcp_server.py file. It may be experimental or require further configuration.
What are the key dependencies?
What are the key dependencies?
Key dependencies include fastapi, uvicorn, mcp, google-api-python-client, google-generativeai, python-dotenv, httpx, and beautifulsoup4. See requirements.txt for the full list.