Content
# 🚀 miri.dev MCP (Model Context Protocol) Tool
[](https://badge.fury.io/js/miridev-mcp)
[](https://opensource.org/licenses/MIT)
MCP(Model Context Protocol) tool that allows you to deploy websites to miri.dev by communicating with AI and natural language.
## ✨ Key Features
- 🚀 **Natural Language Deployment**: Deploy with commands like "Deploy my homepage to miri.dev"
- 🔐 **Easy Authentication**: Login with email/password (CLI and MCP support)
- 📊 **Status Monitoring**: Check deployment status and site list
- 🤖 **AI Friendly**: Integration with Claude Desktop, ChatGPT, etc.
- 🛠️ **CLI Tool**: Deploy and manage directly from the terminal
- ✅ **Stability Improvement**: Fixed login errors, improved testing environment
## 🔧 Claude Desktop Configuration
### 1. Configuration File Location
```bash
# macOS
~/Library/Application Support/Claude/claude_desktop_config.json
# Windows
%APPDATA%/Claude/claude_desktop_config.json
```
### 2. Add MCP Server Configuration
**Recommended Method (NPX):**
```json
{
"mcpServers": {
"miridev": {
"command": "npx",
"args": ["miridev-mcp", "server"]
}
}
}
```
**Local Installation Method:**
```json
{
"mcpServers": {
"miridev": {
"command": "node",
"args": ["/absolute/path/to/miridev-mcp/src/index.js"]
}
}
}
```
## 🎯 MCP Tools
Tools available in Claude Desktop:
- `deploy_website`: Deploy website
- `check_auth_status`: Check authentication status
- `login_miridev`: Login management
- `get_deployment_status`: Check deployment status
- `deployment-guide`: Deployment guide per project
## 🖥️ CLI Usage
### Installation
```bash
npm install -g miridev-mcp
```
### Basic Commands
```bash
# Login
miri-mcp login
miri-mcp login --email your@email.com --password yourpassword
# Deploy
miri-mcp deploy
miri-mcp deploy --path ./my-project --name my-site
# Check Status
miri-mcp status
# Logout
miri-mcp logout
# MCP Server Mode (for Claude Desktop)
miri-mcp server
# Automatically Add Claude Desktop Configuration
miri-mcp config --claude
```
## 💬 AI Usage Examples
Ask Claude Desktop like this:
```
"Deploy my portfolio website to miri.dev"
"Deploy the ./my-project folder with the name 'my-portfolio'"
"Create a React project deployment guide"
"Check deployment status"
```
## 🔧 Troubleshooting
### Login Error Occurs
- **Symptom**: readline ERR_USE_AFTER_CLOSE error
- **Solution**: Use CLI flags `miri-mcp login --email your@email.com --password password`
### Claude Desktop Integration Fails
1. Restart Claude Desktop
2. Check configuration file path
3. Automatically configure with the `miri-mcp config --claude` command
### ES Module Error During Test Execution
- Jest + Babel configuration automatically handles ES Modules
- Install dependencies before running `npm test`: `npm install`
## 📞 Support
- 🌐 [miri.dev](https://www.miri.dev)
- 📖 [docs.miri.dev](https://docs.miri.dev)
- 🐛 [GitHub Issues](https://github.com/hongsw/www.miri.dev/issues)
---
**Enjoy your deployment! 🚀✨**
Connection Info
You Might Also Like
everything-claude-code
Complete Claude Code configuration collection - agents, skills, hooks,...
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
servers
Model Context Protocol Servers
servers
Model Context Protocol Servers
Time
A Model Context Protocol server for time and timezone conversions.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.