Servidor MCP de entrada de tiempo en lenguaje natural Harvest

Un servidor MCP que permite registrar las entradas de tiempo de Harvest en lenguaje natural, incluyendo un manejo especial para solicitudes de permisos. Este servidor facilita el seguimiento del tiempo al comprender las entradas en lenguaje natural y gestionar automáticamente situaciones comunes, como las solicitudes de permisos.

Características

• 🗣️ Análisis de entradas de tiempo en lenguaje natural
• 🏖️ Manejo de solicitudes de licencia especial (por ejemplo, "Hoy estoy de baja por enfermedad")
• ⏰ Horas de jornada laboral configurables
• 🌍 Soporte de zona horaria
• 🎯 Coincidencia automática de proyectos y tareas
• 📅 Análisis inteligente de fechas (hoy, ayer, etc.)

Prerrequisitos

• Node.js instalado
• Un relato de Harvest
• Token de acceso personal de Harvest Developer Tools
• ID de cuenta (que se muestra en la misma página que su token)

Instalación

Instalación

1. Instalar la aplicación de escritorio Claude
2. Clonar este repositorio:

3. Instalar dependencias y compilar:

4. Ejecute el script de configuración:

5. Siga las instrucciones para ingresar su:
   • Token de acceso personal de Harvest (desde https://id.getharvest.com/developers )
   • ID de cuenta de Harvest
   • Horas de jornada laboral estándar (predeterminado: 7,5)
   • Zona horaria (predeterminada: Australia/Perth)
6. Reiniciar la aplicación de escritorio de Claude

¡Listo! Ya puedes usar el seguimiento de tiempo en lenguaje natural en Claude.

Mantenerse actualizado

Para actualizar a la última versión:

El script de instalación habrá configurado a Claude para usar su compilación local del servidor, por lo que cualquier actualización que extraiga estará disponible automáticamente después de la reconstrucción.

Uso

El servidor proporciona varias herramientas para interactuar con Harvest:

tiempo_de_registro

Registrar las entradas de tiempo con lenguaje natural. Ejemplos:

Entradas de tiempo regulares:

Solicitudes de licencia (utiliza automáticamente las horas laborales estándar):

obtener_informe_de_tiempo

Obtenga informes de tiempo mediante consultas en lenguaje natural. Ejemplos:

1. Opciones de período de tiempo:

2. Tipos de informes:

• Por proyecto (predeterminado):
  "Show time report for last month" "Get project hours for this week"
• Por el cliente:
  "Show time report by client for this month" "Get hours by client for Q1"
• Por tarea:
  "Show time summary by task for January" "Get task breakdown for last week"
• Por miembro del equipo:
  "Show team hours for last week" "Get time report by user for this month"

3. Detalles del informe: Cada informe incluye:

• Total de horas trabajadas
• Horas facturables vs. no facturables
• Importes facturables (si tiene permiso)
• Detalles del proyecto/cliente/tarea/usuario según el tipo de informe

lista_proyectos

Enumere todos los proyectos de Harvest disponibles:

lista_de_tareas

Enumere las tareas disponibles para un proyecto específico:

entradas de lista

Ver entradas de tiempo recientes:

Configuración

El servidor admite estas variables de entorno:

• HARVEST_ACCESS_TOKEN : Su token de acceso personal de Harvest
• HARVEST_ACCOUNT_ID : Su ID de cuenta de Harvest
• STANDARD_WORK_DAY_HOURS : Horas predeterminadas para una jornada laboral completa (valor predeterminado: 7,5)
• TIMEZONE : Su zona horaria (predeterminada: Australia/Perth)

Desarrollo

El servidor está construido utilizando:

• Mecanografiado
• Kit de desarrollo de software de MCP
• chrono-node para el análisis de fechas en lenguaje natural
• API de cosecha v2

Para contribuir:

1. Bifurcar el repositorio
2. Crear una rama de características
3. Enviar una solicitud de extracción

Licencia

Licencia MIT: consulte LICENCIA para obtener más detalles