Gmail Send

MCPAI代理

提供方 baddif

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一款支持Markdown格式的Gmail邮件发送工具,专为AI代理和MCP兼容应用设计,提供SMTP集成和App密码认证。

一句话选型结论

按资料字段整理

Gmail Send 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

邮件发送Python本地部署Gmail集成Markdown支持AI代理MCP兼容

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python3 mcp_server.py --test

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Gmail Send当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方baddif上游标注的维护方 baddif
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.8 KB
来自项目仓库与上游目录的原文,未做删改

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.安装```bash

Clone the repository

git clone
cd mcp-server-gmail-send

Run automated installation

chmod +x install.sh
./install.sh


### 2.Gmail设置

1. **启用双因素身份验证** 在您的Gmail帐户中
1. **生成应用程序密码**:
- 转到Google帐户→ 安全→ 2-步骤验证→ 应用程序密码
- 选择“邮件”并生成密码
- 保存16个字符的密码(例如。, `abcd efgh ijkl mnop`)

### 3.克劳德桌面集成```bash
# Copy configuration to Claude Desktop
cp claude_desktop_config.json ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Restart Claude Desktop

4.测试设置```bash

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内容示例````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)

```python
def get_project_status():
return "Active"````

````

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

### Basic Email Sending```python
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函数调用格式```json

{
"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:```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`

## 🧪 测试

### 自动化测试```bash
# 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

手动测试```bash

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套房/工作区 带有应用程序密码的帐户
  • 双因素身份验证 必需的

📊 响应格式

成功响应```json

{
"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"
}
}


### 错误响应```json
{
"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)```bash

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)

## 🆘 故障排除

### 常见问题

#### 身份验证错误```bash
# Verify App Password format (16 characters)
# Check 2FA is enabled
# Generate new App Password

模块导入错误```bash

Check Python path

export PYTHONPATH=/path/to/mcp-server-gmail-send

Verify file permissions

chmod 644 gmail_send_skill.py


#### MCP连接问题```bash
# 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

🤝 贡献

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

开发设置```bash

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发送邮件。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Gmail Send 怎么安装?

在客户端按下面的安装命令接入:python3 mcp_server.py --test。装完在客户端配置里引用同一个包或端点。

Gmail Send 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Gmail Send 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Gmail Send 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Gmail Send 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Gmail Send 能提供哪些能力?

资料显示能力标签包括 AI代理、Python、Claude、Gmail集成。具体工具清单以官方文档为准。

Gmail Send 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Gmail Send 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。