# Smithery.ai MCP Server Deployment Guide
## Overview
This guide documents the deployment of two MCP servers to Smithery.ai:
- **wuolah-mcp**: https://github.com/samihalawa/wuolah-mcp.git
- **huggingface-mcp**: https://github.com/samihalawa/huggingface-mcp.git
## Prerequisites
- GitHub account with access to the repositories
- Both repositories must have valid `smithery.yaml` configuration files
- Browser access to https://smithery.ai/
## Deployment Steps
### Step 1: Navigate to Smithery.ai
1. Open https://smithery.ai/
2. Click the orange "Deploy Server" button in the top navigation
### Step 2: Authenticate with GitHub
1. On the deployment page, click "Continue with GitHub"
2. Complete the GitHub OAuth authentication
3. Grant necessary permissions to Smithery.ai
### Step 3: Deploy wuolah-mcp
1. Navigate to https://smithery.ai/new
2. In the repository input field, enter: `samihalawa/wuolah-mcp`
3. Smithery.ai will automatically detect the `smithery.yaml` configuration
4. Click "Deploy" or press Enter to initiate deployment
5. Wait for the deployment to complete
### Step 4: Deploy huggingface-mcp
1. Navigate to https://smithery.ai/new (for a fresh deployment)
2. In the repository input field, enter: `samihalawa/huggingface-mcp`
3. Smithery.ai will automatically detect the `smithery.yaml` configuration
4. Click "Deploy" or press Enter to initiate deployment
5. Wait for the deployment to complete
### Step 5: Verify Deployments
Check that both deployments are live:
- wuolah-mcp: https://smithery.ai/server/@samihalawa/wuolah-mcp
- huggingface-mcp: https://smithery.ai/server/@samihalawa/huggingface-mcp
## Expected Deployment URLs
Once deployed, the MCP servers will be available at:
- **wuolah-mcp**: `https://smithery.ai/server/@samihalawa/wuolah-mcp`
- **huggingface-mcp**: `https://smithery.ai/server/@samihalawa/huggingface-mcp`
## Installation Commands
After deployment, users can install the MCP servers using:
```bash
# Install wuolah-mcp
npm install -g @smithery/wuolah-mcp
# Install huggingface-mcp
npm install -g @smithery/huggingface-mcp
```
## Troubleshooting
### Common Issues
1. **Authentication Required**: If you see a login prompt, authenticate with GitHub
2. **Repository Not Found**: Ensure the repository name is correct and accessible
3. **Missing smithery.yaml**: Both repositories must have valid configuration files
4. **Deployment Timeout**: Large repositories may take longer to deploy
### Repository Configuration
Both repositories contain `smithery.yaml` files with the following structure:
```yaml
servers:
- name: [server-name]
description: [description]
type: node
script: dist/index.js
```
## Automation Scripts
Three automation scripts are available:
1. `automated_smithery_deploy.js` - Full automation attempt
2. `smithery_deploy_v2.js` - Improved automation with error handling
3. `smithery_deploy_final.js` - Manual intervention assisted automation
## Status Verification
Use these commands to verify deployment status:
```bash
# Check wuolah-mcp status
curl -I https://smithery.ai/server/@samihalawa/wuolah-mcp
# Check huggingface-mcp status
curl -I https://smithery.ai/server/@samihalawa/huggingface-mcp
```
## Notes
- Both repositories are confirmed ready for deployment
- All necessary dependencies are properly configured
- The deployment process should complete within 5-10 minutes per repository
- Screenshots are automatically captured during the automated deployment process
