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