FreeloMCP

FreeloMCP

3.1
developer_toolsproject_managementai_chatbot

If you are the rightful owner of FreeloMCP and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Freelo MCP Server is an unofficial community project that provides a proxy server for communication with the Freelo API using the Model Context Protocol (MCP).

Freelo MCP Server (Neoficiální)

Upozornění: Toto je neoficiální komunitní projekt a není přímo podporován společností Freelo.

MCP Server pro Freelo API v1 - implementace proxy serveru pro komunikaci s Freelo API pomocí Model Context Protocol (MCP). Freelo je česká služba pro projektové řízení a správu úkolů.

O projektu

Freelo MCP Server poskytuje rozhraní pro komunikaci s Freelo API pomocí Model Context Protocol (MCP). Umožňuje integraci Freelo do AI asistentů jako je Cline, Claude a další, kteří podporují MCP protokol.

Projekt obsahuje dvě hlavní komponenty:

  1. REST API Server - Tradiční REST API pro komunikaci s Freelo API
  2. MCP Server - Server implementující Model Context Protocol pro použití s AI asistenty

Instalace

Lokální instalace

# Klonování repozitáře
git clone https://github.com/karlost/FreeloMCP.git
cd FreeloMCP

# Instalace závislostí
npm install

Instalace jako npm balíček

# Globální instalace
npm install -g freelo-mcp

# Nebo použití bez instalace
npx freelo-mcp

Konfigurace

Před použitím je potřeba nastavit proměnné prostředí pro autentizaci s Freelo API. Existují dvě možnosti konfigurace:

1. Pomocí souboru .env

Vytvořte soubor .env v kořenovém adresáři projektu s následujícím obsahem:

# Volitelné nastavení serveru
PORT=3000
NODE_ENV=development

# Povinné autentizační údaje pro Freelo API
FREELO_EMAIL=vas@email.cz
FREELO_API_KEY=VAS_API_KLIC
FREELO_USER_AGENT=freelo-mcp

2. Přímo pomocí proměnných prostředí

Můžete také nastavit proměnné prostředí přímo při spuštění:

FREELO_EMAIL=vas@email.cz FREELO_API_KEY=VAS_API_KLIC FREELO_USER_AGENT=freelo-mcp node mcp-server.js

Požadavky na systém

  • Node.js verze 18.0.0 nebo vyšší

Spuštění

REST API Server

# Vývojové prostředí
npm run dev

# Produkční prostředí
npm start

MCP Server

# Vývojové prostředí
npm run mcp:dev

# Produkční prostředí
npm run mcp

# Pomocí npx (po instalaci balíčku)
freelo-mcp

# Pomocí npx (bez instalace)
npx freelo-mcp

# Lokální spuštění
node bin/freelo-mcp.js

Integrace s Cline

Pro integraci s Cline (AI asistent podporující MCP) vytvořte soubor cline_mcp_settings.json ve vašem domovském adresáři s následujícím obsahem:

{
  "mcpServers": {
    "freelo-mcp": {
      "command": "node",
      "args": ["bin/freelo-mcp.js"],
      "env": {
        "NODE_ENV": "production",
        "FREELO_EMAIL": "vas@email.cz",
        "FREELO_API_KEY": "VAS_API_KLIC",
        "FREELO_USER_AGENT": "freelo-mcp"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ujistěte se, že:

  1. Cesta k souboru bin/freelo-mcp.js je správná (může se lišit podle způsobu instalace)
  2. Autentizační údaje (FREELO_EMAIL, FREELO_API_KEY) jsou správné
  3. Po nastavení restartujte Cline, aby se změny projevily

Testování

Projekt obsahuje automatizované testy pro ověření funkčnosti MCP nástrojů. Testy používají mockování API pomocí knihovny nock a nepotřebují reálné přihlašovací údaje.

Spuštění všech testů

npm test

Spuštění konkrétního testu

npm test -- tests/mcp-tools-simple.test.js

Spuštění testů s pokrytím kódu

npm test -- --coverage

Autentizace

REST API

Autentizace probíhá pomocí HTTP Basic Authentication. Jako uživatelské jméno se používá email pro přihlášení do Freelo a jako heslo API klíč.

Každý požadavek musí obsahovat hlavičku User-Agent.

Autentizace v MCP

Při použití MCP serveru je autentizace prováděna výhradně pomocí proměnných prostředí:

  • Nastavte proměnné prostředí FREELO_EMAIL, FREELO_API_KEY a FREELO_USER_AGENT v souboru .env nebo v cline_mcp_settings.json
  • Všechny MCP nástroje automaticky použijí tyto hodnoty pro autentizaci s Freelo API
  • Není potřeba předávat autentizační údaje v každém požadavku

Dostupné MCP nástroje

Následující tabulka zobrazuje stav implementace jednotlivých MCP nástrojů na základě posledního testování:

KategorieNástrojPopisStavPoznámka
Projektyget_projectsZískání vlastních projektů✅
get_all_projectsZískání všech projektů✅
create_projectVytvoření nového projektu✅
get_project_detailsZískání detailu projektu✅
archive_projectArchivace projektu✅
activate_projectAktivace projektu✅
delete_projectSmazání projektu✅
Úkolyget_all_tasksZískání všech úkolů (globálně, s filtry)⚠️Vrací úkoly ze všech projektů i při použití filtru projectId.
create_taskVytvoření nového úkolu v tasklistu✅
get_task_detailsZískání detailu konkrétního úkolu✅
edit_taskÚprava existujícího úkolu✅
delete_taskSmazání úkolu✅
finish_taskDokončení úkolu✅
activate_taskAktivace úkolu✅
Tasklistyget_project_tasklistsZískání taskistů pro projekt✅
create_tasklistVytvoření nového tasklistu v projektu✅
get_tasklist_tasksZískání úkolů v tasklistu✅
Uživateléget_usersZískání seznamu všech uživatelů✅
remove_workersOdstranění pracovníků z projektu❌Selhává s chybou 404.
Souboryget_all_filesZískání seznamu všech souborů a dokumentů✅
upload_fileNahrání souboru❌Selhává s chybou TypeError (očekává Blob místo Base64).
download_fileStažení souboru❓Netestováno (závisí na upload_file).
Podúkolycreate_subtaskVytvoření nového podúkolu k úkolu⚠️Vrací nesprávné task_id v odpovědi.
get_subtasksZískání seznamu podúkolů úkolu⚠️Vrací podúkoly z celého projektu místo filtrování dle taskId.
Komentářecreate_commentPřidání komentáře k úkolu✅
edit_commentÚprava komentáře✅
Štítkyadd_labels_to_taskPřidání štítků k úkolu✅
remove_labels_from_taskOdstranění štítků z úkolu✅

Legenda:

  • ✅: Funkční
  • ⚠️: Funkční s problémy/neočekávaným chováním
  • ❌: Nefunkční
  • ❓: Netestováno

Příspěvky a další vývoj

Pokud chcete přispět k vývoji tohoto projektu, můžete vytvořit pull request nebo otevřít issue na GitHubu.

Návrhy na další vývoj:

  • Implementace dalších MCP nástrojů pro pokrytí všech funkcí Freelo API
  • Vylepšení dokumentace a příkladů použití
  • Přidání podpory pro další funkce Freelo API (notifikace, štítky, atd.)

Licence

Tento projekt je licencován pod licencí MIT.

Autor

Chodeec (karlost)

Related MCP Servers

View all developer_tools servers →
claude-task-master

claude-task-master

4.8

by eyaltoledano

Task Master is a task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.

ai_chatbot
deepwiki-mcp

deepwiki-mcp

4.6

by regenrek

This is an unofficial Deepwiki MCP Server that processes Deepwiki URLs, crawls pages, converts them to Markdown, and returns documents or lists by page.

browser_automation
mcp-shrimp-task-manager

mcp-shrimp-task-manager

4.6

by cjo4m06

MCP Shrimp Task Manager is an intelligent task management system based on Model Context Protocol (MCP), designed to enhance programming workflows for AI Agents.

os_automation
mindsdb

mindsdb

4.5

by mindsdb

MindsDB is an open-source server that enables seamless interaction with large-scale federated data using the Model Context Protocol (MCP).

databases
terraform-mcp-server

terraform-mcp-server

4.5

by hashicorp

The Terraform MCP Server is a Model Context Protocol server that integrates with Terraform Registry APIs for advanced automation in Infrastructure as Code development.

cloud_platforms
mcp-server-calculator

mcp-server-calculator

4.4

by githejie

A Model Context Protocol server for calculating. This server enables LLMs to use calculator for precise numerical calculations.

developer_tools
mcp-svelte-docs

mcp-svelte-docs

4.4

by spences10

A Model Context Protocol (MCP) server that provides a comprehensive reference guide for Svelte 5, helping LLMs provide accurate guidance when users are working with Svelte.

developer_tools
Sequential Thinking

Sequential Thinking

4.3

by modelcontextprotocol

An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.

research_and_data
Everything MCP Server

Everything MCP Server

4.3

by modelcontextprotocol

The Everything MCP Server is a comprehensive test server designed to demonstrate the full capabilities of the Model Context Protocol (MCP). It is not intended for production use but serves as a valuable tool for developers building MCP clients.

developer_tools
Office-PowerPoint-MCP-Server

Office-PowerPoint-MCP-Server

4.3

by GongRzhe

A MCP server for PowerPoint manipulation using python-pptx, providing tools for creating, editing, and manipulating PowerPoint presentations.

file_systems
whois-mcp

whois-mcp

4.3

by bharathvaj-ganesan

The Whois MCP server allows AI agents to perform WHOIS lookups to retrieve domain details.

research_and_data
n8n-workflow-builder

n8n-workflow-builder

4.2

by makafeli

The n8n Workflow Builder MCP Server is designed to manage n8n workflows, providing tools for workflow management and execution management.

developer_tools
mindmap-mcp-server

mindmap-mcp-server

4.2

by YuChenSSR

A Model Context Protocol (MCP) server for converting Markdown content to interactive mindmaps.

developer_tools
github-mcp-server

github-mcp-server

4.1

by github

The GitHub MCP Server is a Model Context Protocol server that integrates with GitHub APIs for automation and interaction.

developer_tools
algorand-mcp

algorand-mcp

4.1

by GoPlausible

This is a Model Context Protocol (MCP) implementation for Algorand blockchain interactions, providing a server package for blockchain interactions and a client package for wallet management and transaction signing.

communication
mcp-datetime

mcp-datetime

4.0

by ZeparHyfar

A datetime formatting service implemented as an MCP server for the Claude Desktop Application.

developer_tools
Diff

Diff

4.0

by benjamine

diff-mcp is an MCP Server designed to compare text or data and provide a diff.

developer_tools
exa-mcp-server

exa-mcp-server

3.8

by exa-labs

A Model Context Protocol (MCP) server allows AI assistants to use the Exa AI Search API for real-time web searches in a secure manner.

research_and_data
code-assistant

code-assistant

3.8

by stippi

Code Assistant is a CLI tool built in Rust for assisting with code-related tasks, including running as a Model Context Protocol server.

developer_tools
postgres-mcp

postgres-mcp

3.8

by crystaldba

Postgres MCP Pro is an open-source Model Context Protocol server designed to enhance database performance and management through advanced tools and features.

databases
mcp-grafana

mcp-grafana

3.8

by grafana

A Model Context Protocol (MCP) server for Grafana providing access to your Grafana instance and its ecosystem.

monitoring
Sequential Thinking MCP Server

Sequential Thinking MCP Server

3.8

by modelcontextprotocol

An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.

research_and_data
Cua Agent

Cua Agent

3.8

by trycua

cua-mcp-server is a Model Context Protocol (MCP) server for the Computer-Use Agent (CUA), enabling integration with Claude Desktop and other MCP clients.

developer_tools
mcp-atlassian

mcp-atlassian

3.8

by sooperset

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). This integration supports both Confluence & Jira Cloud and Server/Data Center deployments.

cloud_platforms
Nx MCP Server

Nx MCP Server

3.8

by nrwl

A Model Context Protocol server implementation for Nx, providing LLMs with deep access to monorepo structures.

cloud_platforms
Aspire.MCP.Sample

Aspire.MCP.Sample

3.8

by elbruno

Sample MCP Server and MCP client using Aspire.

communication
mcp-server-whisper

mcp-server-whisper

3.8

by arcaputo3

MCP Server Whisper is a Model Context Protocol server designed for advanced audio transcription and processing using OpenAI's Whisper and GPT-4o models.

ai_chatbot