Gmail发送技巧-MCP服务器

🚀 人工智能电子邮件发送技巧 支持模型上下文协议（MCP）

通过Gmail发送电子邮件，使用具有Markdown内容支持的应用密码身份验证，专为AI代理和MCP兼容应用程序设计。

✨ 特性

📧 核心电子邮件功能

Gmail SMTP集成 -通过Gmail的安全SMTP服务器（端口587，TLS）发送电子邮件
应用密码验证 -使用Gmail应用程序密码进行安全身份验证
丰富的错误报告 -详细的成功/失败反馈，包括错误类型
输入验证 -全面的电子邮件和参数验证

📝 增强的Markdown支持（v1.1.0+）

高级Markdown转换 -带有扩展的完整markdown库支持（BSD许可证）
专业电子邮件样式 -具有响应式设计的电子邮件安全CSS
优雅的回退系统 -外部库不可用时的基本Markdown转换器
商业许可证合规性 -商业用途的BSD许可依赖项
电子邮件客户端兼容性 -为主要电子邮件客户端优化HTML

🤖 人工智能集成

MCP兼容 -AI代理的完整模型上下文协议支持
OpenAI函数调用 -与OpenAI函数调用标准兼容
技能框架 -独立和集成执行模式

🚀 快速开始

1.安装

# Clone the repository
git clone 
cd mcp-server-gmail-send

# Run automated installation
chmod +x install.sh
./install.sh

2.Gmail设置

启用双因素身份验证 在您的Gmail帐户中
生成应用程序密码:

- 转到Google帐户→ 安全→ 2-步骤验证→ 应用程序密码 - 选择“邮件”并生成密码 - 保存16个字符的密码（例如。， abcd efgh ijkl mnop)

3.克劳德桌面集成

# Copy configuration to Claude Desktop
cp claude_desktop_config.json ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Restart Claude Desktop

4.测试设置

# Test the MCP server
python3 mcp_server.py --test

# Run comprehensive tests
python3 test_gmail_skill.py

📧 用法示例

增强的Markdown到HTML转换（v1.1.0+）

该技能现在支持使用专业电子邮件样式进行高级Markdown转换：

支持的Markdown功能

标头（H1-H6）具有适当的层次结构
文本格式 -粗体、斜体、删除线
列表 -有序和无序嵌套
链接 -自动链接格式化
代码块 -语法高亮显示和内联代码
引用 -专业报价风格
表格 -响应式表格设计（带markdown库）

电子邮件样式功能

📱 响应式设计 -适应桌面和移动电子邮件客户端
🎨 专业CSS -干净、现代的电子邮件外观
📧 电子邮件客户端兼容性 -适用于Gmail、Outlook、Apple Mail等。
🔧 优雅的后退 -高级功能不可用时的基本转换

Markdown内容示例

# Project Status Report

## Executive Summary
The project is **on track** with key milestones achieved:

### Completed Tasks ✅
1. User authentication system
2. Database schema design
3. API endpoints implementation

### In Progress 🚧
- Front-end development
- Integration testing
- Performance optimization

> **Note**: All deliverables are meeting quality standards.

For technical details, see: [Project Documentation](https://example.com/docs)

def get_project_status(): return "Active"

This Markdown will be converted to professional HTML email format automatically.

Basic Email Sending

from gmail_send_skill import GmailSendSkill
from skill_compat import ExecutionContext

# Initialize
skill = GmailSendSkill()
ctx = ExecutionContext()

# Send email
result = skill.execute(ctx,
    username="your.email@gmail.com",
    app_password="abcd efgh ijkl mnop", 
    content="# Hello World!\n\nThis is a **test** email with *markdown*.",
    to_email="recipient@example.com",
    subject="Test Email from Skill"
)

print(f"Success: {result['success']}")

通过人工智能代理（克劳德桌面）

只需问克劳德：

Can you send an email using the gmail_send function? I need to send:
- From: my.email@gmail.com  
- To: colleague@company.com
- Subject: Project Update
- Content: A markdown report about our progress

I'll provide my app password when prompted.

📊 函数架构

OpenAI函数调用格式

{
  "name": "gmail_send",
  "description": "Send email via Gmail using App Password authentication with Markdown support",
  "parameters": {
    "type": "object", 
    "properties": {
      "username": {
        "type": "string",
        "description": "Gmail address for authentication"
      },
      "app_password": {
        "type": "string", 
        "description": "16-character Gmail App Password"
      },
      "content": {
        "type": "string",
        "description": "Email content in Markdown format"
      },
      "to_email": {
        "type": "string",
        "description": "Recipient email address"
      },
      "subject": {
        "type": "string",
        "description": "Email subject line",
        "default": "Email from Gmail Send Skill"
      },
      "from_name": {
        "type": "string", 
        "description": "Display name for sender",
        "default": null
      }
    },
    "required": ["username", "app_password", "content", "to_email"]
  }
}

📋 项目结构

mcp-server-gmail-send/
├── 📄 gmail_send_skill.py      # Main skill implementation
├── 🔧 skill_compat.py          # Framework compatibility layer  
├── 🖥️  mcp_server.py           # MCP server with stdio transport
├── 📊 version.py               # Version management
├── 🧪 test_gmail_skill.py      # Comprehensive test suite
├── ⚙️  mcp_config.json         # MCP client configuration
├── 🔌 claude_desktop_config.json # Claude Desktop integration
├── 📦 requirements.txt         # Python dependencies
├── 🛠️ install.sh               # Automated installation script
├── 📖 GMAIL_SEND_USAGE.md      # Detailed usage guide
├── 🚀 MCP_DEPLOYMENT.md        # MCP deployment instructions
└── 📝 README.md                # This file

🔧 配置

MCP服务器配置

更新路径 mcp_config.json:

{
  "mcpServers": {
    "gmail-send": {
      "command": "python",
      "args": ["/absolute/path/to/mcp_server.py"],
      "env": {
        "PYTHONPATH": "/absolute/path/to/project"
      }
    }
  }
}

Claude桌面配置

更新 claude_desktop_config.json 使用您的安装路径并复制到：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json

🧪 测试

自动化测试

# Run all tests
python3 test_gmail_skill.py

# Test specific components
python3 test_gmail_skill.py --test TestGmailSendSkill

# Verbose output
python3 test_gmail_skill.py --verbose

手动测试

# Test skill directly
python3 gmail_send_skill.py

# Test MCP server
python3 mcp_server.py --test

# Check version and info
python3 version.py --info

⚙️ 技术细节

依赖关系和许可

核心依赖关系（内置Python）

smtplib -SMTP电子邮件发送
email.mime -电子邮件组成
ssl -TLS加密
json -配置处理
re -用于回退转换的正则表达式

可选增强功能（商业友好型）

标记语言 库（BSD 3条款许可证）

- ✅ 允许商业使用 - ✅ 允许分发 - ✅ 允许修改 - 🔧 不可用时的优雅回退

系统要求

Python 3.7+（测试到3.12）
Gmail SMTP的互联网连接
启用2FA的Gmail帐户

建筑

Gmail Send Skill Architecture
├── gmail_send_skill.py      # Core skill implementation
├── skill_compat.py          # Framework compatibility layer
├── mcp_server.py           # MCP Protocol server
└── version.py              # Version management

HTML Conversion Pipeline:
Markdown Content → Advanced/Basic Converter → CSS Styling → Email HTML

转换系统详细信息

高级模式（带markdown库）

完全支持CommonMark规范
扩展：表格、删除线、任务列表
专业语法高亮
高级表格渲染

回退模式（内置）

基于正则表达式的Markdown解析
核心元素支持（标题、列表、格式）
电子邮件安全HTML生成
保持专业CSS样式

📚 文档

📖 使用指南 -全面的使用说明和示例
🚀 MCP部署 -完整的MCP集成指南
🔧 安装脚本 -自动设置和配置
🧪 测试套件 -全面的测试框架

🔒 安全

最佳实践

✅ 使用应用程序密码 -切勿使用常规Gmail密码
✅ 启用2FA -生成应用程序密码所需
✅ 安全存储 -从不将凭据提交到版本控制
✅ 输入验证 -所有参数在使用前都经过验证
✅ 错误处理 -敏感信息不会出现错误

支持的身份验证

Gmail应用程序密码 （推荐）
G套房/工作区 带有应用程序密码的帐户
双因素身份验证 必需的

📊 响应格式

成功响应

{
  "success": true,
  "function_name": "gmail_send",
  "result": {
    "message": "Email sent successfully to recipient@example.com",
    "timestamp": "2026-02-14T10:30:00",
    "from": "sender@gmail.com",
    "to": "recipient@example.com",
    "subject": "Email Subject"
  }
}

错误响应

{
  "success": false,
  "function_name": "gmail_send", 
  "error": {
    "message": "Authentication failed. Please check your credentials.",
    "type": "authentication_error",
    "details": "SMTP Authentication Error: (535, 'Incorrect password')"
  }
}

🔄 版本信息

当前版本： 1.0.0 (2026-02-14)

# Check version
python3 version.py --version

# Full version info  
python3 version.py --info

# View changelog
python3 version.py --changelog

🛠️ 需求

系统要求

Python 3.7+ （必填）
互联网连接 用于SMTP访问
Gmail帐户 启用2FA

依赖项

内置Python库: smtplib, email, json, logging
可选的: markdown>=3.4.0 （用于丰富格式）

兼容性

✅ MCP协议 2024-11-05
✅ OpenAI函数调用 兼容的
✅ 克劳德桌面 整合
✅ 跨平台 （macOS、Linux、Windows）

🆘 故障排除

常见问题

身份验证错误

# Verify App Password format (16 characters)
# Check 2FA is enabled
# Generate new App Password

模块导入错误

# Check Python path
export PYTHONPATH=/path/to/mcp-server-gmail-send

# Verify file permissions
chmod 644 gmail_send_skill.py

MCP连接问题

# Test MCP server
python3 mcp_server.py --test

# Check Claude Desktop logs
tail -f ~/Library/Logs/Claude/claude-desktop.log

支持资源

📋 使用指南 -详细故障排除
🔧 部署指导 -MCP特定问题
🧪 测试套件 - python3 test_gmail_skill.py
📊 日志 -检查 gmail_send_mcp.log

🤝 贡献

分叉存储库
创建特征分支: git checkout -b feature/amazing-feature
提交更改: git commit -m 'Add amazing feature'
推送到分支: git push origin feature/amazing-feature
打开拉取请求

开发设置

# Clone for development
git clone 
cd mcp-server-gmail-send

# Install development dependencies
pip3 install -r requirements.txt
pip3 install pytest pytest-asyncio  # For testing

# Run tests
python3 test_gmail_skill.py

# Check code style
python3 -m flake8 gmail_send_skill.py

� 版本历史记录

v1.1.0（2024-12-19）-增强的Markdown支持

✨ 高级Markdown转换 -带有扩展的完整markdown库支持
🎨 专业电子邮件样式 -电子邮件客户端的响应式CSS
🔧 优雅的回退系统 -外部库不可用时的基本转换器
⚖️ 商业许可证合规性 -BSD许可依赖项
📧 电子邮件客户端优化 -提高了跨平台的兼容性
🧪 增强测试 -全面的转换和造型测试

v1.0.0（2024-12-19）-初始版本

📧 Gmail SMTP集成 -通过Gmail安全发送电子邮件
🔐 应用密码验证 -安全的凭证处理
🤖 MCP协议支持 -完整模型上下文协议实现
📝 基本Markdown支持 -简单的标记到HTML转换
✅ 全面测试 -18个单元测试，边缘情况覆盖
🛠️ 本地开发工具 -配置模板和测试工具

�📄 许可证

本项目根据许可证文件。

第三方许可证合规性

markdown库 （可选）-BSD 3条款许可证-允许商业使用
Python标准库 -Python软件基础许可证

🙏 致谢

模型上下文协议 -用于标准化的AI代理集成
OpenAI函数调用 -对于函数模式标准
Gmail SMTP -可靠的电子邮件传递基础设施
Python社区 -对于优秀的库和工具
Markdown社区 -对于BSD许可的markdown处理库

______________________________________________________________________

专为人工智能驱动的应用而构建 🤖 | MCP兼容 🔌 | 生产就绪 🚀

*Gmail Send Skill v1.1.0-通过专业电子邮件样式增强Markdown转换* 通过gmail发送邮件。

Gmail Send

快速接入

详细介绍

Gmail发送技巧-MCP服务器

✨ 特性

📧 核心电子邮件功能

📝 增强的Markdown支持（v1.1.0+）

🤖 人工智能集成

🚀 快速开始

1.安装

2.Gmail设置

3.克劳德桌面集成

4.测试设置

📧 用法示例

增强的Markdown到HTML转换（v1.1.0+）

支持的Markdown功能

电子邮件样式功能

Markdown内容示例

Basic Email Sending

通过人工智能代理（克劳德桌面）

📊 函数架构

OpenAI函数调用格式

📋 项目结构

🔧 配置

MCP服务器配置

Claude桌面配置

🧪 测试

自动化测试

手动测试

⚙️ 技术细节

依赖关系和许可

核心依赖关系（内置Python）

可选增强功能（商业友好型）

系统要求

建筑

转换系统详细信息

高级模式（带markdown库）

回退模式（内置）

📚 文档

🔒 安全

最佳实践

支持的身份验证

📊 响应格式

成功响应

错误响应

🔄 版本信息

🛠️ 需求

系统要求

依赖项

兼容性

🆘 故障排除

常见问题

身份验证错误

模块导入错误

MCP连接问题

支持资源

🤝 贡献

开发设置

� 版本历史记录

v1.1.0（2024-12-19）-增强的Markdown支持

v1.0.0（2024-12-19）-初始版本

�📄 许可证

第三方许可证合规性

🙏 致谢

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP