Gmail智能聊天机器人

通过MCP协议和LangGraph集成Gmail与语言模型的智能聊天机器人,提供基于邮件的对话界面。

  • by AirtonLira
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 airtonlira/mcp_gmail_langgraph

使用说明

Gmail聊天机器人

智能聊天机器人,通过模型上下文协议(MCP)和LangGraph将Gmail与语言模型集成。

它做什么

  • Streamlit 中的聊天界面,用于与 Gmail 电子邮件交谈
  • 使用 Llama 3.1 8B 模型与 Ollama 集成
  • 通过 Google Gmail API 安全访问电子邮件
  • 用于模型和服务之间通信的 MCP 协议
  • 用于编排智能代理的 LangGraph

要求

  • Python 3.11或更高级
  • Docker e Docker编写
  • 启用 Gmail API 的 Google 帐户
  • 查看已安装( 或使用容器)

安装

  1. 克隆仓库
git clone <url-do-repositorio>
cd gmail-chatbot
  1. 配置 Google 凭据

    • 访问 Google Cloud Console
    • 创建项目并启用 Gmail API
    • 下载 JSON 凭据档案
    • 另存为 credentials/credentials.json
  2. 执行com Docker

docker-compose up -d

如何使用

  1. 访问http://localhost:8501在浏览器中
  2. 首次,您将被指示使用Google进行身份验证
  3. 验证后,开始谈论您的电子邮件

项目结构

gmail-chatbot/
├── docker-compose.yml          # Orquestração dos containers
├── Dockerfile                  # Container da aplicação
├── requirements.txt            # Dependências Python
├── credentials/                # Credenciais do Google (não versionado)
├── src/
│   ├── app.py                 # Interface Streamlit principal
│   ├── agents/                # Agentes LangGraph
│   ├── mcp/                   # Configuração MCP para Gmail
│   ├── llm/                   # Cliente Ollama
│   └── utils/                 # Utilitários e configurações
└── docker/
    └── ollama/                # Docker personalizado do Ollama

主要技术

  • 溪流:界面web
  • LangGraph: 代理人编排
  • MCP(模型上下文协议): 与服务的沟通
  • Ollama+火焰3.1本地语言模板
  • 谷歌Gmail API访问电子邮件
  • 码头工人: 容器化

有用的命令

停止服务 :

docker-compose down

版本日志:

docker-compose logs -f

重建应用程序:

docker-compose build

高级设置

该项目使用以下端口 :

  • 8501:接口流光
  • 11434:Ollama API

要修改设置,请编辑文件 docker-compose.yml.