miri.dev MCP Integration

miri.dev MCP는 AI와 자연어로 소통하여 웹사이트를 배포할 수 있는 Model Context Protocol 도구입니다. Claude Desktop, ChatGPT 등의 AI 어시스턴트와 연동하여 간단한 명령어로 웹사이트를 배포할 수 있습니다.

주요 기능

🚀 자연어 배포

"내 홈페이지를 miri.dev에 배포해줘"와 같은 자연어 명령으로 웹사이트를 배포할 수 있습니다.

🔐 간편한 인증

이메일/비밀번호로 간단하게 로그인하여 miri.dev 계정과 연동됩니다.

📊 상태 모니터링

배포 상태, 사이트 목록, 배포 기록을 AI를 통해 확인할 수 있습니다.

🤖 AI 친화적

Claude Desktop, ChatGPT 등 다양한 AI 도구와 연동 가능합니다.

Claude Desktop 설정

1. 설정 파일 위치

Claude Desktop의 MCP 서버 설정 파일을 열어주세요:

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows  
%APPDATA%/Claude/claude_desktop_config.json

2. MCP 서버 설정 추가

설정 파일에 다음 내용을 추가해주세요:

NPX 방식 (권장)

{
  "mcpServers": {
    "miridev": {
      "command": "npx",
      "args": ["miridev-mcp", "server"]
    }
  }
}

로컬 설치 방식

{
  "mcpServers": {
    "miridev": {
      "command": "node",
      "args": ["/절대경로/miridev-mcp/src/index.js"],
      "env": {
        "MIRI_API_URL": "https://www.miri.dev/api"
      }
    }
  }
}

사용 가능한 MCP 도구

Claude Desktop에서 다음과 같은 도구들을 사용할 수 있습니다:

`deploy_website`

기능: 웹사이트 배포
사용법: "내 프로젝트를 배포해줘", "./build 폴더를 배포하라"
옵션: 프로젝트 경로, 사이트 이름 지정 가능

`check_auth_status`

기능: 인증 상태 확인
사용법: "로그인 상태를 확인해줘"
결과: 현재 사용자 정보 및 로그인 상태

`login_miridev`

기능: 로그인 관리
사용법: "miri.dev에 로그인하고 싶어"
옵션: 강제 재로그인 가능

`get_deployment_status`

기능: 배포 상태 확인
사용법: "최근 배포 상태를 알려줘"
결과: 배포 기록 및 사이트 목록

`deployment-guide`

기능: 프로젝트별 배포 가이드
사용법: "React 프로젝트 배포 가이드를 만들어줘"
옵션: 프로젝트 타입 지정 (html, react, vue 등)

AI 사용 예시

Claude Desktop에서 다음과 같이 자연어로 요청할 수 있습니다:

기본 배포

"내 포트폴리오 웹사이트를 miri.dev에 배포해줘"

특정 폴더 배포

"./my-project 폴더를 'my-portfolio'라는 이름으로 배포하라"

프로젝트별 가이드

"React 프로젝트 배포 가이드를 만들어줘"
"Vue 앱을 배포하는 방법을 알려줘"

상태 확인

"배포 상태 확인해줘"
"내 사이트 목록을 보여줘"
"로그인 상태를 체크해줘"

기술 사양

FastMCP 기반

프레임워크: FastMCP (TypeScript)
통신 방식: STDIN/STDOUT
호환성: MCP 표준 준수

지원 기능

자연어 처리: 배포 명령 자동 해석
실시간 피드백: 배포 진행 상황 실시간 업데이트
오류 처리: 친화적인 오류 메시지 및 해결 방법 제시

보안

토큰 관리: 로컬 안전 저장
HTTPS 통신: 모든 API 호출 암호화
권한 제어: 사용자별 접근 권한 관리

문제 해결

연결 문제

Claude Desktop 재시작
MCP 서버 설정 확인
네트워크 연결 상태 점검

인증 문제

check_auth_status 도구로 로그인 상태 확인
필요시 login_miridev 도구로 재로그인

배포 실패

프로젝트에 index.html 파일 존재 확인
파일 크기 25MB 이하 확인
네트워크 연결 상태 점검

개발자 정보

npm 패키지

패키지명: miridev-mcp
최신 버전: v1.0.5
설치: npx miridev-mcp

소스 코드

GitHub: github.com/hongsw/www.miri.dev
라이센스: MIT

지원

웹사이트: miri.dev
문서: docs.miri.dev
이슈 신고: GitHub Issues

업데이트 로그

v1.0.5 (2025-01-02)

Claude Desktop 설정 문서 간소화
자동 설정 스크립트 제거
FastMCP 기반 구현 완료

v1.0.4 (2025-01-02)

README 대폭 간소화
config.json 설정 중심으로 재구성

v1.0.3 (2025-01-02)

FastMCP 프레임워크 도입
STDIN/STDOUT 통신 지원

MCP를 통해 더 쉽고 빠른 웹사이트 배포를 경험해보세요!

miri.dev MCP (Model Context Protocol) Integration