MCP Forwardemail

转发电子邮件MCP服务器

⚠️ 非官方的 -这是一个非官方的MCP服务器 转发电子邮件。它不隶属于Forward Email LLC，也不受其认可或支持。

一个MCP（模型上下文协议）服务器，为Claude Desktop、Cline和其他兼容MCP的客户端提供对ForwardEmail API的全面访问。

特性

• 31个MCP工具 涵盖ForwardEmail API
• 域管理 -列出、创建、更新、删除域；验证DNS/SMTP记录
• 别名管理 -带有转发规则的电子邮件别名的完整CRUD
• 出站电子邮件 -通过API发送电子邮件，检查限制，管理队列
• 团队协作 -邀请成员，管理角色
• 安全 -IMAP/SMTP访问密码生成，TXT记录加密
• 异步/等待 -采用现代Python异步模式构建
• 类型安全 -Pydantic模型的完整类型提示

先决条件

• python: 3.10+
• 紫外线：0.4+（推荐）
• uvx：包括紫外线
• 具有API访问权限的ForwardEmail帐户
• API密钥来自 转发电子邮件安全设置

安装

使用uvx（推荐）

uvx --from git+https://github.com/junxit/mcp-forwardemail.git forwardemail-mcp

使用pip

pip install git+https://github.com/junxit/mcp-forwardemail.git

来源

git clone https://github.com/junxit/mcp-forwardemail.git
cd mcp-forwardemail
uv pip install -e .

配置

克劳德桌面版

添加到您的 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "forwardemail": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/junxit/mcp-forwardemail.git", "forwardemail-mcp"],
      "env": {
        "FORWARDEMAIL_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用Claude Desktop进行本地开发

{
  "mcpServers": {
    "forwardemail": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-forwardemail", "run", "forwardemail-mcp"],
      "env": {
        "FORWARDEMAIL_API_KEY": "your_api_key_here"
      }
    }
  }
}

持续/延长

添加到MCP设置中：

{
  "forwardemail": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/junxit/mcp-forwardemail.git", "forwardemail-mcp"],
    "env": {
      "FORWARDEMAIL_API_KEY": "your_api_key_here"
    }
  }
}

环境变量

或者，将API键设置为环境变量：

export FORWARDEMAIL_API_KEY="your_api_key_here"

可用工具

账户（3个工具）

域名（10个工具）

别名（6个工具）

出站电子邮件（5个工具）

邀请（3个工具）

成员（2个工具）

日志（1个工具）

加密（1个工具）

使用示例

列出您的域名

问克劳德： *“列出我的ForwardEmail域名”*

创建电子邮件别名

问克劳德： *在example.com上创建一个名为“support”的别名，转发到admin@gmail.com"*

发送电子邮件

问克劳德： *“从发送电子邮件hello@example.com到user@gmail.com主题为“测试”，正文为“你好！'"*

验证域设置

问克劳德： *“验证DNS记录，例如.com”*

API限制

以下ForwardEmail API终结点需要 别名凭据 （电子邮件+生成的密码）而不是API令牌身份验证，并且 不支持 在此MCP服务器中：

• 别名联系人（CardDAV）
• Alias日历（CalDAV）
• 别名邮件（IMAP/POP3）
• 别名文件夹（IMAP/POP3）

故障排除

“身份验证失败”错误

• 验证您的API密钥是否正确
• 检查钥匙是否正确设置 env MCP配置的一部分
• 确保键周围没有多余的空格或引号

“FORWARDEMAIL_API_KEY环境变量是必需的”

• 确保您已添加 env MCP配置部分
• 更改配置后重新启动Claude Desktop

未找到工具

• 重新启动Claude Desktop以重新加载MCP服务器
• 检查Claude Desktop日志中的启动错误

发展

# Clone the repository
git clone https://github.com/junxit/mcp-forwardemail.git
cd mcp-forwardemail

# Install in development mode
uv pip install -e ".[dev]"

# Run tests
uv run pytest tests/ -v

# Run the server locally
FORWARDEMAIL_API_KEY="your_key" uv run python -m forwardemail_mcp

如何测试

# Run unit tests
uv run pytest tests/ -v

# Run with coverage
uv run pytest tests/ --cov=forwardemail_mcp

# Run single test file
uv run pytest tests/test_client.py -v

如何卸载

# If installed via pip/uv
pip uninstall forwardemail-mcp

# Remove from Claude Desktop config
# Edit ~/Library/Application Support/Claude/claude_desktop_config.json
# and remove the "forwardemail" entry from mcpServers

清理本地文件

# Remove Python cache files
find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null
find . -type f -name "*.pyc" -delete
find . -type f -name "*.pyo" -delete

# Remove virtual environments
rm -rf .venv venv ENV .uv

# Remove build artifacts
rm -rf build dist *.egg-info .eggs

# Remove test/coverage artifacts
rm -rf .pytest_cache .coverage htmlcov .tox

# Remove the project directory (if installed from source)
cd .. && rm -rf mcp-forwardemail

假设

• ForwardEmail API保持稳定在 https://api.forwardemail.net
• API身份验证继续使用HTTP基本身份验证
• MCP SDK 1.0+版本保持当前接口
• 用户具有启用API访问的有效ForwardEmail帐户

贡献

欢迎投稿！拜托：

1. 克隆该仓库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

链接

• 转发电子邮件 -电子邮件服务
• 转发电子邮件API文档 -API官方文件
• -GitHub官方组织
• MCP文件 -模型上下文协议文档

许可证

MIT许可证-请参阅 许可证 文件。

______________________________________________________________________

免责声明：这是一个非官方的、由社区维护的项目。ForwardEmail是Forward Email LLC的商标。本项目不隶属于Forward Email LLC.，也不受其认可或支持。