🤖 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:

npm i -g @railway/cli

2. Crear nuevo proyecto:

railway login
railway init
railway up

3. Configurar variables:

railway variables set WEB_MODE=true

4. Obtener URL:

railway status

Opción 2: Desplegar en Vercel

1. Instalar Vercel CLI:

npm i -g vercel

2. Desplegar:

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

{
  "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:

node index.js

Modo Claude Web:

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:

{
  "tool": "get_tasks_stats",
  "arguments": {}
}

Ejemplo con argumentos:

{
  "tool": "create_task",
  "arguments": {
    "title": "Nueva tarea desde Claude Web",
    "priority": "high"
  }
}

🔍 Verificar Funcionamiento

Probar API directamente:

curl https://tu-mcp-server.railway.app/mcp/tools

Ejecutar herramienta:

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