MMCPMarkets
KF

karlost/freelomcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

10 stars 3 forks 品質 86 トレンド 32MIT
Repository Install

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

概要

Toto je neoficiální komunitní projekt a není přímo podporován společností Freelo. MCP Server pro Freelo API v1 - kompletní implementace Model Context Protocol serveru pro komunikaci s Freelo API. Freelo je česká služba pro projektové řízení a správu úkolů. - 🚀 pokrývajících 100% Freelo API v1 - ✅ - 207 unit testů + 82 real API testů - 🔧 - Všechny známé bugy opraveny - 📊 - Podpora pro pagination a advanced filters - 🔒 - HTTP Basic Authentication s API klíčem - 🎯 - Token limit fixes pro velké datasety - 📝 - Detailní popis všech tools - 🏷️ - Automatické behavioral hints (readOnly, destructive, idempotent) - 📋 - Zod schemas pro validaci všech API odpovědí - 🧩 - Tools organizovány v 19 modulech Nejjednodušší způsob jak začít používat Freelo MCP je přes npx - není potřeba nic instalovat! 1. - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json 4.

README

以下は原文 README の抜粋です。原文を見る。

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 - kompletní implementace Model Context Protocol serveru pro komunikaci s Freelo API. Freelo je česká služba pro projektové řízení a správu úkolů.

✨ Vlastnosti

  • 🚀 104 MCP tools pokrývajících 100% Freelo API v1
  • ✅ Plně otestováno - 207 unit testů + 82 real API testů
  • 🔧 Production-ready - Všechny známé bugy opraveny
  • 📊 Smart filtering - Podpora pro pagination a advanced filters
  • 🔒 Bezpečné - HTTP Basic Authentication s API klíčem
  • 🎯 Optimalizováno - Token limit fixes pro velké datasety
  • 📝 Kompletní dokumentace - Detailní popis všech tools
  • 🏷️ MCP Annotations - Automatické behavioral hints (readOnly, destructive, idempotent)
  • 📋 OutputSchema - Zod schemas pro validaci všech API odpovědí
  • 🧩 Modulární architektura - Tools organizovány v 19 modulech

📊 Stav projektu

Metrika Hodnota
Celkem MCP tools 104
Funkčních tools 100%
Opravené bugy 16/16 (100%)
API pokrytí 100% Freelo API v1
Unit testy 207 (205 passed, 2 skipped)
Real API testy 82 passed, 0 failed
Testováno ✅ Kompletní validation

🚀 Rychlý start

Instalace přes NPX (doporučeno)

Nejjednodušší způsob jak začít používat Freelo MCP je přes npx - není potřeba nic instalovat!

1️⃣ Pro Claude Desktop (Anthropic Desktop)

  1. Najděte konfigurační soubor:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Přidejte Freelo MCP server do konfigurace:

{
  "mcpServers": {
    "freelo": {
      "command": "npx",
      "args": ["-y", "freelo-mcp"],
      "env": {
        "FREELO_EMAIL": "[email protected]",
        "FREELO_API_KEY": "VAS_API_KLIC",
        "FREELO_USER_AGENT": "FreeloMCP/3.0.0 ([email protected])"
      }
    }
  }
}

  1. Restartujte Claude Desktop

  2. Ověření:

    • V Claude Desktop byste měli vidět 🔌 ikonu v dolním panelu
    • Zkuste: “Zobraz moje Freelo projekty”

2️⃣ Pro Claude Code (CLI)

  1. Přidání MCP serveru jedním příkazem:
claude mcp add freelo-mcp \
GitHub で README 全文を見る

インストール

npx -y freelo-mcp
MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "freelo": { "command": "npx", "args": ["-y", "freelo-mcp"], "env": { "FREELO_EMAIL": "[email protected]", "FREELO_API_KEY": "VAS_API_KLIC", "FREELO_USER_AGENT": "FreeloMCP/3.0.0 ([email protected])" } } } }