MCP Servers

Mail MCP Server

An MCP server that provides email sending capabilities via SMTP, featuring tools for sending standard and template-based emails. It utilizes the FastMCP Streamable HTTP transport for flexible client connectivity over HTTP without requiring stdio subprocesses.

README

Mail MCP Server

基于 FastMCP 的邮件发送能力，以 MCP Streamable HTTP 传输启动，供支持该协议的客户端通过 HTTP 连接（无需 stdio 子进程）。

Features

传输：streamable-http（FastMCP 内与 http / sse 并列的 transport）
MCP 工具：send_email、send_template_email
监听：MCP_HOST / MCP_PORT（默认 0.0.0.0:8000）
Docker 镜像非 root 运行，依赖层与代码层分离缓存

Prerequisites

Project Structure

mail-mcp-server
├── src
│   ├── mcp_server.py          # MCP 入口（streamable-http）
│   ├── main.py
│   ├── email_service/
│   └── tests/
├── pyproject.toml
├── uv.lock
├── Dockerfile
├── docker-compose.yml
├── .dockerignore
├── .env.example
└── README.md

启动

cd mail-mcp-server
cp .env.example .env
uv sync
uv run python src/mcp_server.py

Streamable HTTP 端点：http://<MCP_HOST>:<MCP_PORT>/mcp（例如 http://127.0.0.1:8000/mcp）。

.env 为何未生效？

见 .env 与 load_env 说明：需在项目根放置 .env，修改后重启 MCP 进程。

环境变量

变量	说明	默认
`MCP_HOST` / `MCP_PORT`	监听	`0.0.0.0` / `8000`
`SMTP_*` / `DEFAULT_SENDER` / `EMAIL_FROM`	发信	见 `.env.example`
`SMTP_SSL` / `SMTP_USE_STARTTLS`	465 / 587	见 `fastmcp_client.py` 与 README 163 小节

163 `Connection unexpectedly closed`

问题	处理
用户名非完整邮箱	使用 `user@163.com`
FROM 写成授权码	FROM 必须是邮箱；授权码只在 `SMTP_PASSWORD`
587 被断开	使用 `SMTP_PORT=465` + `SMTP_SSL=true`，或依赖自动走 465

一次性演示（非 MCP）

uv run python src/main.py

Docker

镜像特点

项	说明
分层	先 `pyproject.toml` + `uv.lock` + `uv sync`，再 `COPY src/`，改代码不重建依赖层
环境	`UV_LINK_MODE=copy`、`--compile-bytecode`，减少告警并略加快启动
安全	`USER app`（uid 1000），非 root
布局	`PYTHONPATH=/app/src`，`CMD` 为 `python -m mcp_server`

构建

# 默认 bookworm + Python 3.10
docker build -t mail-mcp-server:latest .

# 加快构建（跳过 apt upgrade）
docker build --build-arg SKIP_APT_UPGRADE=1 -t mail-mcp-server:latest .

# 指定 Python 小版本
docker build --build-arg PYTHON_VERSION=3.11 -t mail-mcp-server:py311 .

运行

docker run --rm -p 8000:8000 --env-file .env mail-mcp-server:latest

Compose

服务名 mail-mcp（原 email-sender 已更名）：

docker compose up --build -d

端口：宿主机 ${MCP_PORT:-8000} → 容器 8000（容器内仍监听 8000，改端口请同时设置环境变量并映射）。
healthcheck：对容器内 127.0.0.1:8000 做 TCP 探测（Streamable HTTP 未必有 GET /）。
重启策略：unless-stopped。

Development

uv sync --group dev
uv run pytest
uv lock

License

MIT

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured