AI agent이 영구적인 이메일 수신함을 생성하고, 일회용 비밀번호(OTP)를 읽으며, 이메일을 보낼 수 있도록 지원합니다.
다른 이름 MailFlat/mailflat-sdks, mailflat-sdks, mailflat-mcp
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- 236
- 최신 버전
- 0.9.2
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- MIT
MailFlat MCP란?
MailFlat은(는) MCP server입니다. AI agent이 영구적인 이메일 수신함을 생성하고, 일회용 비밀번호(OTP)를 읽으며, 이메일을 보낼 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
MailFlat MCP server 정보
MailFlat은 AI agent 및 자동화 테스트 스위트가 영구적인 이메일 수신함을 관리할 수 있는 방법을 제공합니다. 개발자는 여러 번의 실행 과정에서도 유지되는 주소를 생성할 수 있으며, 이는 회원가입 흐름 테스트나 agent 통신 관리 시 유용합니다. 일회용 이메일 서비스와 달리, 이 주소들은 활성 상태를 유지하며 사용자가 메시지 보관 기간을 직접 제어할 수 있습니다.
사용자는 MailFlat 대시보드에서 발급받은 mf_live_로 시작하는 account key를 사용하여 서비스에 연결합니다. mailflat-mcp 패키지를 사용하면 Claude 또는 Cursor와 같은 AI assistant가 이러한 수신함과 직접 상호작용할 수 있습니다. 이 시스템은 사용자 정의 레이블을 포함한 새 수신함 생성, 전용 검색 도구를 통한 일회용 비밀번호 읽기, 이메일 전송 등 특정 작업을 지원합니다. 이 설정은 Python, JavaScript, Java용 다양한 SDK를 통해 로컬 개발 환경과 원격 agent 환경 모두에서 작동합니다.
활용 사례
- 1자동 OTP 추출AI agent가 수신함에서 인증 코드를 기다리고 추출하여 회원가입 프로세스를 완료할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
MailFlat MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 MailFlat MCP 설치
$ claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpCursor에 MailFlat MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}VS Code에 MailFlat MCP 설치
.vscode/mcp.json
{
"servers": {
"mailflat-sdks": {
"type": "stdio",
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}VS Code CLI에 MailFlat MCP 설치
$ code --add-mcp '{"name":"mailflat-sdks","type":"stdio","command":"uvx","args":["mailflat-mcp"],"env":{"MAILFLAT_API_KEY":"<YOUR_MAILFLAT_API_KEY>"}}'Claude Desktop에 MailFlat MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}Codex에 MailFlat MCP 설치
$ codex mcp add mailflat-sdks --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' -- uvx mailflat-mcpCodex config.toml에 MailFlat MCP 설치
~/.codex/config.toml
[mcp_servers.mailflat-sdks] command = "uvx" args = ["mailflat-mcp"] [mcp_servers.mailflat-sdks.env] MAILFLAT_API_KEY = "<YOUR_MAILFLAT_API_KEY>"
Gemini CLI에 MailFlat MCP 설치
$ gemini mcp add -s user -e 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks uvx -- mailflat-mcpGemini settings.json에 MailFlat MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}구성
MAILFLAT_API_KEY필수비밀MailFlat API key. Create one in the dashboard under Agents.
MAILFLAT_API_URLOverride the API base URL. Defaults to https://mailflat.net.
| 이름 | 설명 | 유형 |
|---|---|---|
| MAILFLAT_API_KEY | MailFlat API key. Create one in the dashboard under Agents. | 필수비밀 |
| MAILFLAT_API_URL | Override the API base URL. Defaults to https://mailflat.net. |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능mailflat/mailflat-sdks is public and reachablegithub.com/mailflat/mailflat-sdks ↗통과
- 패키지가 이 저장소를 소스로 명시mailflat-mcp names mailflat/mailflat-sdks as sourcepypi.org/project/mailflat-mcp/ ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-13github.com/mailflat/mailflat-sdks ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from mailflat-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음31 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기MailFlat SDKs
Official client libraries for MailFlat: email inboxes your code owns, with one-line OTP retrieval. Built for test suites (Selenium, pytest, Playwright) and AI agents.
Addresses are permanent, so a suite does not need a fresh one per run. Only the messages expire, on a retention window you choose.
This repo holds only the open-source SDKs. The MailFlat service itself is closed-source.
Packages
| Package | For | Install |
|---|---|---|
mailflat |
Python | pip install mailflat |
@mailflat/sdk |
JavaScript / TypeScript | npm i @mailflat/sdk |
mailflat-mcp |
AI assistants (Claude, Cursor) — MCP | uvx mailflat-mcp |
@mailflat/ai-sdk |
Vercel AI SDK agents | npm i @mailflat/ai-sdk |
mailflat.langchain |
LangChain agents | pip install "mailflat[langchain]" |
mailflat-sdk (Java) |
Java / Selenium | via JitPack — see below |
Each client is a thin, typed wrapper over the same /api/v1 Agent API, so they behave identically.
Authenticate with your account key (mf_live_…) from the dashboard (Agents → API keys).
Java / Selenium (JitPack)
JitPack derives the
groupIdfrom the GitHub owner. This repo moved to the officialMailFlataccount in August 2026, so releases fromv0.4.4on publish ascom.github.MailFlat:mailflat-sdks. Earlier versions still resolve under the old coordinatecom.github.onderyentar21:mailflat-sdks; the old repo stays up for them. The client is moving to Maven Central (net.mailflat) next, which ends the owner coupling.
<repositories>
<repository><id>jitpack.io</id><url>https://jitpack.io</url></repository>
</repositories>
<dependency>
<groupId>com.github.MailFlat</groupId>
<artifactId>mailflat-sdks</artifactId>
<version>v0.8.1</version>
</dependency>
MailFlat mf = new MailFlat("mf_live_…");
Inbox inbox = mf.create("signup");
driver.findElement(By.id("email")).sendKeys(inbox.address());
String otp = inbox.waitForOtp(30); // polls until the code arrives
driver.findElement(By.id("code")).sendKeys(otp);
Quick examples
Python
from mailflat import MailFlat
mf = MailFlat(api_key="mf_live_…")
inbox = mf.create(label="signup")
otp = inbox.wait_for_otp(timeout=30)
JavaScript / TypeScript
import { MailFlat } from "@mailflat/sdk";
const mf = new MailFlat({ apiKey: process.env.MAILFLAT_API_KEY });
const inbox = await mf.create({ label: "signup" });
const otp = await inbox.waitForOtp({ timeout: 30000 });
License
MIT. The full text is in LICENSE at the repository root; each package directory carries an identical copy.
MailFlat MCP 질문
MailFlat MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
MailFlat MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
MailFlat 인증은 어떻게 하나요?
MailFlat 대시보드의 Agents → API keys 메뉴에서 발급받은 account key(mf_live_...로 시작)를 사용하여 인증합니다.
이메일 주소는 일시적인가요?
아니요, 이메일 주소는 영구적입니다. 다만 메시지는 사용자가 설정한 보관 기간에 따라 만료됩니다.
지원되는 프로그래밍 언어는 무엇인가요?
MailFlat은 Python, JavaScript/TypeScript, Java용 SDK를 제공하며, LangChain 및 Vercel AI SDK 연동도 지원합니다.