Freedcamp MCP-сервер

Это реализация сервера Model Context Protocol (MCP) для управления задачами Freedcamp. Она предоставляет инструменты для создания, обновления и удаления задач в проектах Freedcamp.

Функции

• Создавайте новые задачи с названием, описанием, приоритетом, сроком выполнения и ответственным лицом.

• Обновление существующих задач, включая изменение статуса

• Удалить задачи

• Поддержка переменных среды для учетных данных

• Обработка ошибок и проверка

Related MCP server: Basecamp MCP Server

Предпосылки

• Node.js 17 или выше

• Машинопись

• Аккаунт Freedcamp с доступом к API

• API-ключ и секрет от Freedcamp

• Идентификатор проекта от Freedcamp

Установка (только для ручного вызова, не требуется для использования с IDE или другим клиентом рабочего стола MCP)

1. Клонируйте репозиторий:

git clone <repository-url>
cd freedcamp-mcp

2. Установить зависимости:

npm install

3. Создайте файл .env в корневом каталоге с вашими учетными данными Freedcamp:

FREEDCAMP_API_KEY=your_api_key
FREEDCAMP_API_SECRET=your_api_secret
FREEDCAMP_PROJECT_ID=your_project_id

Использование

Запуск сервера

Сначала создайте код TypeScript:

npm run build

Затем запустите сервер:

npm start

Запуск тестового жгута

Проект включает в себя комплексную тестовую систему, которая проверяет все функциональные возможности MCP:

npm test

Тестовая аппаратура выполняет следующие проверки:

1. Инициализация сервера с правильной версией протокола

2. Перечень инструментов и проверка возможностей

3. Создание задач с различными параметрами

4. Обновления задач, включая изменения статуса

5. Перечень задач и проверка

Доступные инструменты

1. freedcamp_add_task

   • Создает новую задачу в Freedcamp

   • Параметры:

     • title (обязательно): Название задачи

     • description (необязательно): Описание задачи

     • priority (необязательно): Приоритет задачи (0-3)

     • due_date (необязательно): дата выполнения задачи (ГГГГ-ММ-ДД)

     • assigned_to_id (необязательно): идентификатор пользователя, которому будет назначена задача

2. freedcamp_update_task

   • Обновляет существующую задачу

   • Параметры:

     • task_id (обязательно): идентификатор задачи для обновления

     • title (необязательно): Новое название задачи

     • description (необязательно): Описание новой задачи

     • priority (необязательно): новый приоритет задачи (0-3)

     • due_date (необязательно): Новая дата выполнения (ГГГГ-ММ-ДД)

     • assigned_to_id (необязательно): новый идентификатор пользователя, которому будет назначена задача

     • status (необязательно): новый статус задачи (0=открыта, 1=завершена, 2=закрыта)

3. freedcamp_list_tasks

   • Перечисляет все задачи в настроенном проекте Freedcamp.

   • Параметры не требуются (использует идентификатор проекта из переменных среды)

   • Возвращает список задач с их подробностями

Интеграция с IDE

Сервер можно запустить напрямую с помощью npx , без клонирования репозитория.

Курсор

1. Откройте (или создайте) .cursor/mcp.json в корневом каталоге вашего проекта.

2. Добавьте конфигурацию сервера 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. Перезапустите курсор или перезагрузите серверы MCP.

Ру

1. Откройте (или создайте) файл конфигурации Roo MCP (обычно roo.mcp.json или аналогичный).

2. Добавьте конфигурацию сервера 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"
         }
       }
     }
   }