CLI와 MCP server를 통해 이메일 인프라, 인증 및 배포를 관리합니다.
다른 이름 smbcloudXYZ/smbcloud-cli, smbcloud-cli, @smbcloud/cli
- 스타
- 12
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.2.0
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- —
smbCloud MCP란?
smbCloud은(는) MCP server입니다. CLI와 MCP server를 통해 이메일 인프라, 인증 및 배포를 관리합니다.
프로젝트 README에서 생성된 요약
smbCloud MCP server 정보
smbCloud Mail & Auth는 AI 에이전트를 통해 이메일 인프라, 인증 및 배포를 관리할 수 있게 해줍니다. 이 MCP server를 사용하면 개발자는 웹 브라우저 없이도 Mail, Auth, Deploy, GresIQ와 같은 smbCloud 기능을 사용할 수 있습니다. 이 서버는 stdio를 통해 Model Context Protocol을 제공하여 해당 프로토콜을 지원하는 AI 클라이언트에서 접근할 수 있도록 작동합니다.
사용자는 smb 바이너리에서 사용하는 것과 동일한 명령어나 REST API를 사용하여 이러한 작업을 워크플로에 통합할 수 있습니다. 이 서버는 터미널 사용자, CI 작업 및 AI 에이전트 모두를 위해 설계되었습니다. 또한 --mcp --scope automation 플래그를 통해 특화된 자동화를 지원하며, 모바일 및 TV 자동화 작업을 위해 Xcode, ControlKit, CoreDevice, adb와 같은 도구를 제공합니다.
활용 사례
- 1자동화된 인프라 배포AI 에이전트가 로그인부터 첫 배포 수행까지의 전체 프로세스를 처리할 수 있습니다.
- 2모바일 및 TV 자동화개발자는 특정 자동화 스코프를 통해 모바일 기기와 TV 하드웨어를 제어하는 데 이 서버를 사용할 수 있습니다.
- 3지속적 통합(CI) 워크플로대화형 프롬프트를 사용할 수 없는 자동화된 환경에서 smbCloud 작업을 실행할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
smbCloud MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 smbCloud MCP 설치
$ claude mcp add --env 'SMB_MAIL_API_KEY=<YOUR_SMB_MAIL_API_KEY>' smbcloud-cli -- npx -y @smbcloud/cliCursor에 smbCloud MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"smbcloud-cli": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
],
"env": {
"SMB_MAIL_API_KEY": "<YOUR_SMB_MAIL_API_KEY>"
}
}
}
}VS Code에 smbCloud MCP 설치
.vscode/mcp.json
{
"servers": {
"smbcloud-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
],
"env": {
"SMB_MAIL_API_KEY": "<YOUR_SMB_MAIL_API_KEY>"
}
}
}
}VS Code CLI에 smbCloud MCP 설치
$ code --add-mcp '{"name":"smbcloud-cli","type":"stdio","command":"npx","args":["-y","@smbcloud/cli"],"env":{"SMB_MAIL_API_KEY":"<YOUR_SMB_MAIL_API_KEY>"}}'Claude Desktop에 smbCloud MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"smbcloud-cli": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
],
"env": {
"SMB_MAIL_API_KEY": "<YOUR_SMB_MAIL_API_KEY>"
}
}
}
}Codex에 smbCloud MCP 설치
$ codex mcp add smbcloud-cli --env 'SMB_MAIL_API_KEY=<YOUR_SMB_MAIL_API_KEY>' -- npx -y @smbcloud/cliCodex config.toml에 smbCloud MCP 설치
~/.codex/config.toml
[mcp_servers.smbcloud-cli] command = "npx" args = ["-y", "@smbcloud/cli"] [mcp_servers.smbcloud-cli.env] SMB_MAIL_API_KEY = "<YOUR_SMB_MAIL_API_KEY>"
Gemini CLI에 smbCloud MCP 설치
$ gemini mcp add -s user -e 'SMB_MAIL_API_KEY=<YOUR_SMB_MAIL_API_KEY>' smbcloud-cli npx -- -y @smbcloud/cliGemini settings.json에 smbCloud MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"smbcloud-cli": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli"
],
"env": {
"SMB_MAIL_API_KEY": "<YOUR_SMB_MAIL_API_KEY>"
}
}
}
}구성
SMB_MAIL_API_KEY비밀Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.
| 이름 | 설명 | 유형 |
|---|---|---|
| SMB_MAIL_API_KEY | Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`. | 비밀 |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기Every smbCloud capability works without a browser. You reach it through the REST API first, then through smb, then through its MCP server, and each one covers the same operations. smb is one binary with no runtime to install, so a person at a terminal, a CI job and an AI agent all run the same commands against the same account.
Install
brew tap smbcloudXYZ/tap && brew trust --tap smbcloudXYZ/tap && brew install cli
npm install -g @smbcloud/cli
cargo install smbcloud-cli
More ways, including .NET, pip, shell, PowerShell and pre-built binaries, are in docs/install.md.
Use it your way
- In the terminal.
smb login && smb init && smb deploytakes you from a fresh login to a first deploy. See interfaces. - In scripts and CI.
smb --citurns off prompts, so a missing answer fails fast instead of hanging. See CI mode. - With AI agents.
smb --mcpserves the Model Context Protocol over stdio, and it is listed in the MCP Registry asio.github.smbcloudXYZ/smbcloud-cli. See MCP. - For mobile and TV automation.
smb --mcp --scope automationexposes Xcode, ControlKit, CoreDevice and adb tools. See ControlKit.
Docs
Install, interfaces, CI, MCP, MCP Registry, ControlKit, AndroidKit, development. The index is docs/README.md.
Contributing
Read CONTRIBUTING.md to get started. Contributions are welcome.
License
Copyright
© 2026 Seto Elkahfi (smbCloud). Distributed by Splitfire AB.
smbCloud MCP 질문
smbCloud MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SMB_MAIL_API_KEY=<YOUR_SMB_MAIL_API_KEY>' smbcloud-cli -- npx -y @smbcloud/cli를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
smbCloud MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
smbCloud를 사용하려면 브라우저가 필요한가요?
아니요, smbCloud의 모든 기능은 REST API, CLI 또는 MCP server를 통해 브라우저 없이도 사용할 수 있습니다.
CI/CD 환경에서 smbCloud를 어떻게 사용하나요?
--ci 플래그를 사용하여 대화형 프롬프트를 비활성화하십시오. 이렇게 하면 응답이 누락되었을 때 프로세스가 멈추지 않고 즉시 실패하도록 보장할 수 있습니다.