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

Related MCP server: Basecamp MCP Server

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:

git clone <repository-url>
cd freedcamp-mcp

2. Instalar dependencias:

npm install

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

FREEDCAMP_API_KEY=your_api_key
FREEDCAMP_API_SECRET=your_api_secret
FREEDCAMP_PROJECT_ID=your_project_id

Uso

Ejecución del servidor

Primero construya el código TypeScript:

npm run build

Luego inicia el servidor:

npm start

Ejecución del arnés de prueba

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

npm test

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"
         }
       }
     }
   }