Skip to main content
Glama

🤖 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
  1. Crear nuevo proyecto:

railway login
railway init
railway up
  1. Configurar variables:

railway variables set WEB_MODE=true
  1. Obtener URL:

railway status

Opción 2: Desplegar en Vercel

  1. Instalar Vercel CLI:

npm i -g vercel
  1. 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

Available Tools

8 tools
create_taskC

Crea una nueva tarea

Inputs: title (required), detail, priority.

delete_taskC

Elimina permanentemente una tarea

Inputs: id (required).

get_api_statusB

Obtiene el estado actual de la API de TinyTasks

Inputs: no named parameters.

get_taskC

Obtiene los detalles de una tarea específica

Inputs: id (required).

get_tasks_statsB

Obtiene estadísticas de las tareas: total, completadas, pendientes

Inputs: no named parameters.

list_tasksC

Lista todas las tareas con filtro opcional por estado

Inputs: status.

toggle_taskC

Alterna el estado de completación de una tarea

Inputs: id (required).

update_taskC

Actualiza una tarea existente

Inputs: id (required), title, detail, priority, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: create, delete, get, list, update, toggle, and API status/statistics tools all target specific actions on tasks or system status. An agent can easily differentiate between them based on their descriptions.

    Naming Consistency5/5

    All tools follow a consistent verb_noun naming pattern (e.g., create_task, delete_task, get_task) with clear, descriptive verbs. There are no deviations in style or convention across the set.

    Tool Count5/5

    With 8 tools, this server is well-scoped for task management, covering core CRUD operations (create, get, update, delete), listing, toggling completion, and supplementary functions like stats and API status. Each tool earns its place without bloat.

    Completeness5/5

    The toolset provides complete coverage for task management: full CRUD (create, get, update, delete), lifecycle handling (toggle for completion), listing with filters, statistics, and system status. There are no obvious gaps that would hinder an agent's workflow.

    Related MCP Connectors