freedcamp

Freedcamp MCP-сервер

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

Функции

• Создавайте новые задачи с названием, описанием, приоритетом, сроком выполнения и ответственным лицом.
• Обновление существующих задач, включая изменение статуса
• Удалить задачи
• Поддержка переменных среды для учетных данных
• Обработка ошибок и проверка

Предпосылки

• Node.js 17 или выше
• Машинопись
• Аккаунт Freedcamp с доступом к API
• API-ключ и секрет от Freedcamp
• Идентификатор проекта от Freedcamp

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

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

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

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

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

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

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

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

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

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

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

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