Zimbra MCP

Zimbra MCP服务器

MCP（模型上下文协议）服务器，用于Zimbra管理电子邮件、标签、日历和联系人。

安装

cd ~/Projets/MCP/zimbra-mcp

# With uv
uv sync

# Or with pip
pip install -e .

配置

创建一个 .env 示例中的文件：

cp .env.example .env

配置您的Zimbra凭据：

ZIMBRA_URL=https://zimbra.example.com/service/soap
ZIMBRA_USER=me@example.com
ZIMBRA_PASSWORD=your_password
ZIMBRA_TIMEOUT=30
ZIMBRA_ENABLE_SEND=false

用法

启动服务器

uv run zimbra-mcp

使用MCP检查员进行测试

mcp dev src/zimbra_mcp/server.py

可用工具

电子邮件

回复和转发草稿

create_draft 和 send_email 支持链接到原始邮件进行回复和转发：

示例：

• 简单草稿： create_draft(to=[...], subject="...", body="...")
• 引用回复： create_draft(to=[...], subject="Re: ...", body="...", orig_msg_id="123", reply_type="r", include_original="inline")
• 作为附件转发： create_draft(to=[...], subject="Fwd: ...", body="...", orig_msg_id="123", reply_type="w", include_original="attachment")

Zimbra搜索语法

基本操作员：

• in:inbox -收件箱中的电子邮件
• from:john@example.com -来自John的电子邮件
• to:me -发送给我的电子邮件
• tag:important -带有“重要”标签的电子邮件
• subject:meeting -主题包含“会议”
• has:attachment -带附件的电子邮件
• after:2024-01-01 before:2024-12-31 -日期范围（ISO或MM/DD/YYYY）
• is:unread -未读电子邮件
• is:flagged -标记的电子邮件

布尔运算符

• from:john OR from:mary -来自John或Mary的电子邮件
• NOT is:read 或 -is:read -未读电子邮件（排除）
• (from:john OR from:mary) subject:urgent -分组括号

组合： in:inbox from:boss tag:urgent is:unread

联系人

标签

可选颜色：蓝色、青色、绿色、紫色、红色、黄色、粉色、灰色、橙色

日历

发展

运行测试

# Install test dependencies
uv sync --extra test

# Run tests
uv run pytest

# Verbose output
uv run pytest -v

测试结构

测试使用 unittest.mock 模拟Zimbra SOAP客户端，因此不需要Zimbra服务器。这 capture_tools 夹具 conftest.py 拦截 @mcp.tool() 装饰器直接访问工具功能。

Claude代码集成

添加到MCP配置(~/.claude/settings.json):

{
  "mcpServers": {
    "zimbra": {
      "command": "uv",
      "args": ["run", "--directory", "/home/me/Projets/MCP/zimbra-mcp", "zimbra-mcp"],
      "env": {
        "ZIMBRA_URL": "https://zimbra.example.com/service/soap",
        "ZIMBRA_USER": "me@example.com",
        "ZIMBRA_PASSWORD": "your_password"
      }
    }
  }
}

项目结构

zimbra-mcp/
├── pyproject.toml
├── README.md
├── CLAUDE.md
├── .env.example
├── src/
│   └── zimbra_mcp/
│       ├── __init__.py
│       ├── server.py          # FastMCP entry point
│       ├── config.py          # Configuration
│       ├── client.py          # Zimbra SOAP client
│       ├── errors.py          # Exceptions
│       └── tools/
│           ├── __init__.py
│           ├── emails.py      # Email tools
│           ├── tags.py        # Tag tools
│           ├── contacts.py    # Contact tools
│           └── calendar.py    # Calendar tools
└── tests/
    ├── conftest.py            # Shared fixtures
    ├── test_config.py
    ├── test_errors.py
    ├── test_client.py
    └── tools/
        ├── test_emails.py
        ├── test_tags.py
        ├── test_contacts.py
        └── test_calendar.py