{
  "markdown": "# MailDevMcp\n\nEnglish | [日本語](README.ja.md)\n\n[![CI](https://github.com/pierre3/MailDevMcp/actions/workflows/ci.yml/badge.svg)](https://github.com/pierre3/MailDevMcp/actions/workflows/ci.yml)\n[![NuGet](https://img.shields.io/nuget/v/MailDevMcp.svg)](https://www.nuget.org/packages/MailDevMcp)\n\nmcp-name: io.github.pierre3/maildev-mcp\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server for [MailDev](https://github.com/maildev/maildev).  \nManage MailDev Docker containers and inspect received emails directly from your AI-powered editor or MCP client.\n\nThis server is intended for local development and test automation scenarios where an MCP client needs to:\n\n- start or stop a MailDev container\n- inspect inbox contents\n- wait for emails after triggering application behavior\n- inspect HTML bodies and attachments\n- verify attachment integrity byte-for-byte\n\n## Installation\n\nInstall as a global .NET tool:\n\n```sh\ndotnet tool install -g MailDevMcp\n```\n\nAfter installation, the `maildev-mcp` command becomes available.\n\n## MCP Client Configuration\n\nAdd the following to your MCP client settings (e.g. Claude Desktop, VS Code, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"maildev-mcp\": {\n      \"command\": \"maildev-mcp\",\n      \"env\": {\n        \"MAILDEV_API_PORT\": \"1080\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Default | Description |\n|---|---|---|\n| `MAILDEV_API_PORT` | `1080` | Port number for the MailDev REST API |\n\n## Typical Workflow\n\n1. Call `StartMaildev` to launch a local MailDev container\n2. Trigger your application to send an email\n3. Call `WaitForEmail` if delivery is asynchronous\n4. Use `ListEmails`, `SearchEmails`, or `GetEmail` to inspect the result\n5. Use `GetEmailHtml`, `GetAttachmentContent`, or `VerifyAttachment` when deeper validation is needed\n6. Clean up with `DeleteEmail`, `DeleteAllEmails`, or `StopMaildev`\n\n## Available Tools\n\n| Tool | Description |\n|---|---|\n| `StartMaildev` | Start the MailDev Docker container with configurable SMTP port, API port, authentication, and TLS |\n| `StopMaildev` | Stop and remove the MailDev Docker container |\n| `MaildevStatus` | Check the running status of MailDev |\n| `ListEmails` | Retrieve the list of received emails |\n| `GetEmail` | Get the details of an email by ID, including attachment information |\n| `GetEmailHtml` | Get the HTML body of an email by ID |\n| `SearchEmails` | Search received emails by subject, sender, or recipient |\n| `DeleteEmail` | Delete a single email by ID |\n| `DeleteAllEmails` | Delete all received emails |\n| `WaitForEmail` | Wait until a new email matching given criteria arrives (useful for test automation) |\n| `GetAttachmentContent` | Get the raw Base64-encoded content of an email attachment |\n| `VerifyAttachment` | Verify that an email attachment matches the original data by byte-by-byte comparison |\n\n## Tool Behavior Notes\n\n- `StartMaildev`\n  - Supports custom SMTP and API ports\n  - Supports optional SMTP authentication\n  - Treats empty or whitespace-only credentials as authentication disabled\n  - Supports TLS with a generated self-signed certificate\n- `GetEmail` and `ListEmails`\n  - Render missing or empty subjects as `(no subject)`\n  - Render missing address lists as `(none)`\n- `WaitForEmail`\n  - Polls MailDev until a matching email arrives or the timeout is reached\n  - Reports transient MailDev connection failures in the returned message when they occur during polling\n- `VerifyAttachment`\n  - Accepts a Base64-encoded original payload\n  - Compares the received attachment byte-by-byte\n  - Reports either exact match, size mismatch, or content mismatch\n\n## Requirements and Assumptions\n\n- Docker must be installed and available on the same machine where this MCP server runs\n- MailDev is accessed through its HTTP API on `localhost`\n- The configured API port in the MCP client must match the MailDev API port exposed by Docker\n\n## Prerequisites\n\n- [.NET 10 SDK](https://dotnet.microsoft.com/) or later\n- [Docker](https://www.docker.com/) (for running the MailDev container)\n\n## Building from Source\n\n```sh\ngit clone https://github.com/pierre3/MailDevMcp.git\ncd MailDevMcp\ndotnet pack -c Release\ndotnet tool install -g --add-source ./bin/Release MailDevMcp\n```\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 4256,
  "sha": "e7061afa08235ae7ae6ceec3300a8ea312453b93e0bcabbea6759f7f03978f82",
  "repo_slug": "pierre3/maildevmcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pierre3_maildev_mcp_23709fb0/readme"
}