FastMCP_email_server
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"fastmcp_email_server_pypi": {
"args": [
"fastmcp-email-server"
],
"command": "uvx"
}
}
}可用工具 （7 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
get_newest_email 3 个参数 需填 2 项
获取最新的未读邮件，包括发件人、主题、内容和附件信息 Args: account: 邮箱账号 password: 授权码/密码 imap_server: 自定义IMAP服务器地址（可选，未提供时自动匹配） Returns: 包含邮件信息的字典，包括发件人、主题、日期、内容和附件列表
必填参数：account、password
check_emails 5 个参数 需填 2 项
检查指定类型和数量的邮件 Args: account: 邮箱账号 password: 授权码/密码 message_type: 邮件类型，可选值包括 "All", "Unseen", "Seen", "Recent", "Answered", "Flagged" count: 要检索的邮件数量 imap_server: 自定义IMAP服务器地址（可选，未提供时自动匹配） Returns: 包含邮件信息的字典列表
必填参数：account、password
save_attachment 5 个参数 需填 3 项
保存指定的附件到指定路径 Args: file_name: 要保存的附件文件名 account: 邮箱账号 password: 授权码/密码 save_path: 保存路径，默认为空（当前目录） imap_server: 自定义IMAP服务器地址（可选，未提供时自动匹配） Returns: 保存状态消息
必填参数：file_name、account、password
send_text_email 7 个参数 需填 5 项
发送纯文本邮件 Args: to_addr: 收件人邮箱地址，可以是单个字符串或字符串列表 subject: 邮件主题 content: 邮件正文内容 account: 发送者邮箱账号 password: 授权码/密码 cc_addr: 抄送人邮箱地址，可以是单个字符串或字符串列表（可选） smtp_server: 自定义SMTP服务器地址（可选，未提供时自动匹配） Returns: 包含发送状态和消息的字典
必填参数：to_addr、subject、content、account、password
send_html_email 7 个参数 需填 5 项
发送HTML格式邮件 Args: to_addr: 收件人邮箱地址，可以是单个字符串或字符串列表 subject: 邮件主题 html_content: HTML格式的邮件正文内容 account: 发送者邮箱账号 password: 授权码/密码 cc_addr: 抄送人邮箱地址，可以是单个字符串或字符串列表（可选） smtp_server: 自定义SMTP服务器地址（可选，未提供时自动匹配） Returns: 包含发送状态和消息的字典
必填参数：to_addr、subject、html_content、account、password
send_email_with_attachment 9 个参数 需填 6 项
发送带附件的邮件 Args: to_addr: 收件人邮箱地址，可以是单个字符串或字符串列表 subject: 邮件主题 content: 邮件正文内容 attachment_paths: 附件路径，可以是单个字符串或字符串列表 account: 发送者邮箱账号 password: 授权码/密码 cc_addr: 抄送人邮箱地址，可以是单个字符串或字符串列表（可选） is_html: 内容是否为HTML格式，默认为False smtp_server: 自定义SMTP服务器地址（可选，未提供时自动匹配） Returns: 包含发送状态和消息的字典
必填参数：to_addr、subject、content、attachment_paths、account、password
get_server_config 1 个参数 需填 1 项
根据邮箱地址获取推荐的服务器配置 Args: email: 邮箱地址 Returns: 包含SMTP和IMAP服务器地址的字典
必填参数：email
服务介绍
FastMCP 邮件服务器
基于 FastMCP 框架构建的邮件收发 MCP 服务器，支持多种邮箱服务商的邮件收发和附件处理功能。
在 https://modelscope.cn/mcp/servers/s3219521aa/MCP_Agent_Challenge_email163_mcp 的基础上增加了用户自定义发送邮箱的功能。
🚀 FastMCP 框架特性
FastMCP 提供了简洁的 Python 风格接口，只需使用装饰器即可将函数封装为 MCP 工具：
from fastmcp import FastMCP
mcp = FastMCP("EmailService")
@mcp.tool()
def send_text_email(to_addr: str, subject: str, content: str, account: str, password: str) -> dict:
"""发送纯文本邮件"""
# 实现邮件发送逻辑
return {"status": "success", "message": "邮件发送成功"}
if __name__ == "__main__":
mcp.run(transport="stdio")
📧 提供的邮件工具
邮件接收
get_newest_email: 获取最新的未读邮件check_emails: 检查指定类型和数量的邮件save_attachment: 保存邮件附件到指定路径
邮件发送
send_text_email: 发送纯文本邮件send_html_email: 发送HTML格式邮件send_email_with_attachment: 发送带附件的邮件
服务器配置
get_server_config: 自动获取邮箱服务器配置
工具调用示例
{
"name": "send_text_email",
"arguments": {
"to_addr": "recipient@example.com",
"subject": "测试邮件",
"content": "这是一封测试邮件",
"account": "your-email@163.com",
"password": "your-auth-code"
}
}
⚡ 快速测试
MCP 客户端测试配置
{
"mcpServers": {
"fastmcp_email_server_pypi": {
"command": "uvx",
"args": [
"fastmcp-email-server"
]
}
}
}
同时，ModelScope也提供了Streamable HTTP 和 SSE 协议的部署支持。
