freedcamp

Servidor MCP de Freedcamp

Esta es una implementación de servidor del Protocolo de Contexto de Modelo (MCP) para la gestión de tareas de Freedcamp. Proporciona herramientas para crear, actualizar y eliminar tareas en proyectos de Freedcamp.

Características

• Crear nuevas tareas con título, descripción, prioridad, fecha de vencimiento y asignado
• Actualizar las tareas existentes, incluidos los cambios de estado
• Eliminar tareas
• Compatibilidad de variables de entorno con credenciales
• Manejo de errores y validación

Prerrequisitos

• Node.js 17 o superior
• Mecanografiado
• Cuenta de Freedcamp con acceso a la API
• Clave API y secreto de Freedcamp
• ID del proyecto de Freedcamp

Instalación (solo para invocación manual, no es necesaria para el uso con un IDE u otro cliente de escritorio MCP)

1. Clonar el repositorio:

2. Instalar dependencias:

3. Crea un archivo .env en el directorio raíz con tus credenciales de Freedcamp:

Uso

Ejecución del servidor

Primero construya el código TypeScript:

Luego inicia el servidor:

Ejecución del arnés de prueba

El proyecto incluye un arnés de prueba integral que verifica toda la funcionalidad del MCP:

El arnés de prueba realiza las siguientes comprobaciones:

1. Inicialización del servidor con la versión de protocolo adecuada
2. Listado de herramientas y verificación de capacidad
3. Creación de tareas con varios parámetros
4. Actualizaciones de tareas, incluidos cambios de estado
5. Listado y verificación de tareas

Herramientas disponibles

1. freedcamp_add_task
   • Crea una nueva tarea en Freedcamp
   • Parámetros:
     • title (obligatorio): Título de la tarea
     • description (opcional): Descripción de la tarea
     • priority (opcional): Prioridad de la tarea (0-3)
     • due_date (opcional): Fecha de vencimiento de la tarea (AAAA-MM-DD)
     • assigned_to_id (opcional): ID de usuario al que asignar la tarea
2. freedcamp_update_task
   • Actualiza una tarea existente
   • Parámetros:
     • task_id (obligatorio): ID de la tarea a actualizar
     • title (opcional): Nuevo título de la tarea
     • description (opcional): Nueva descripción de la tarea
     • priority (opcional): Nueva prioridad de la tarea (0-3)
     • due_date (opcional): Nueva fecha de vencimiento (AAAA-MM-DD)
     • assigned_to_id (opcional): Nuevo ID de usuario al que asignar la tarea
     • status (opcional): Estado de la nueva tarea (0=abierta, 1=completada, 2=cerrada)
3. freedcamp_list_tasks
   • Enumera todas las tareas en el proyecto Freedcamp configurado
   • No se requieren parámetros (utiliza el ID del proyecto de las variables de entorno)
   • Devuelve una lista de tareas con sus detalles.

Integración IDE

El servidor se puede ejecutar directamente usando npx sin clonar el repositorio.

Cursor

1. Abra (o cree) .cursor/mcp.json en la raíz de su proyecto.
2. Agregue la configuración de su servidor Freedcamp MCP:
   { "mcpServers": { "freedcamp": { "command": "npx", "args": ["freedcamp-mcp"], "env": { "FREEDCAMP_API_KEY": "your_api_key", "FREEDCAMP_API_SECRET": "your_api_secret", "FREEDCAMP_PROJECT_ID": "your_project_id" } } } }
3. Reinicie el cursor o recargue los servidores MCP.

Roo

1. Abra (o cree) su archivo de configuración Roo MCP (comúnmente roo.mcp.json o similar).
2. Agregue la configuración de su servidor Freedcamp MCP:
   { "mcpServers": { "Freedcamp": { "transport": "stdio", "command": "npx", "args": ["freedcamp-mcp"], "env": { "FREEDCAMP_API_KEY": "your_api_key", "FREEDCAMP_API_SECRET": "your_api_secret", "FREEDCAMP_PROJECT_ID": "your_project_id" } } } }