# 🤖 TinyTasks MCP Server
Servidor MCP híbrido que funciona tanto con **Claude Desktop** como con **Claude Web**.
## ✅ Estado del Proyecto
- **API NestJS**: ✅ Funcionando en `https://forgetful-production-a037.up.railway.app`
- **MCP Server Local**: ✅ Listo para Claude Desktop
- **MCP Server Web**: ✅ Listo para despliegue y Claude Web
- **8 Herramientas**: ✅ Todas implementadas y probadas
## 🛠️ Herramientas Disponibles
1. **get_api_status** - Estado de la API
2. **get_tasks_stats** - Estadísticas de tareas
3. **list_tasks** - Listar tareas (con filtros)
4. **get_task** - Obtener tarea específica
5. **create_task** - Crear nueva tarea
6. **update_task** - Actualizar tarea
7. **toggle_task** - Alternar estado
8. **delete_task** - Eliminar tarea
## 🌐 Para Claude Web (Servidor Público)
### Opción 1: Desplegar en Railway
1. **Instalar Railway CLI:**
```bash
npm i -g @railway/cli
```
2. **Crear nuevo proyecto:**
```bash
railway login
railway init
railway up
```
3. **Configurar variables:**
```bash
railway variables set WEB_MODE=true
```
4. **Obtener URL:**
```bash
railway status
```
### Opción 2: Desplegar en Vercel
1. **Instalar Vercel CLI:**
```bash
npm i -g vercel
```
2. **Desplegar:**
```bash
vercel --prod
```
### Usar en Claude Web
Una vez desplegado, tendrás una URL como:
- Railway: `https://tu-proyecto.railway.app`
- Vercel: `https://tu-proyecto.vercel.app`
**Endpoints disponibles:**
- `GET /` - Información del servidor
- `GET /mcp/tools` - Lista de herramientas
- `POST /mcp/execute` - Ejecutar herramienta
**Ejemplo de uso en Claude Web:**
```
Puedes usar mi MCP server en: https://tu-proyecto.railway.app
Herramientas disponibles en: https://tu-proyecto.railway.app/mcp/tools
Para ejecutar una herramienta, haz POST a: https://tu-proyecto.railway.app/mcp/execute
con el body: {"tool": "get_tasks_stats"}
```
## 🖥️ Para Claude Desktop (Servidor Local)
### 1. Configurar Claude Desktop
Edita: `~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"tinytasks": {
"command": "node",
"args": ["/Users/franciscogoulu/Desktop/Fran Dev/Forgetful3/mcp-tinytasks-server/index.js"],
"env": {
"NODE_ENV": "production"
}
}
}
}
```
### 2. Reiniciar Claude Desktop
## 🧪 Probar Localmente
### Modo Claude Desktop:
```bash
node index.js
```
### Modo Claude Web:
```bash
WEB_MODE=true node index.js
```
Luego visita: `http://localhost:3001`
## 📋 Endpoints de la API Web
### GET /
Información del servidor
### GET /mcp/tools
Lista todas las herramientas disponibles
### POST /mcp/execute
Ejecuta una herramienta específica
**Body:**
```json
{
"tool": "get_tasks_stats",
"arguments": {}
}
```
**Ejemplo con argumentos:**
```json
{
"tool": "create_task",
"arguments": {
"title": "Nueva tarea desde Claude Web",
"priority": "high"
}
}
```
## 🔍 Verificar Funcionamiento
### Probar API directamente:
```bash
curl https://tu-mcp-server.railway.app/mcp/tools
```
### Ejecutar herramienta:
```bash
curl -X POST https://tu-mcp-server.railway.app/mcp/execute \
-H "Content-Type: application/json" \
-d '{"tool": "get_api_status"}'
```
## 🎯 Resumen de Opciones
### Para Claude Desktop:
- Usa el servidor local con protocolo MCP nativo
- Configuración en `claude_desktop_config.json`
### Para Claude Web:
- Despliega el servidor como API REST
- Usa endpoints HTTP para comunicación
- Accesible desde cualquier lugar
¡Ambos modos consumen la misma API de TinyTasks! # Updated Sun Jun 15 20:54:37 -03 2025
