mytaskly/mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

2 stars 0 forks Качество 51 Тренд 8

Repository Install

Model Context Protocol (MCP) server for MyTaskly with OAuth 2.1 JWT authentication and mobile-optimized data formatting

Обзор

for MyTaskly with and seamless integration with the FastAPI backend. - - Token-based authentication following MCP 2025 standards (RFC 8707) - - Server-Sent Events for HTTP-based deployment (Railway-ready) - - Token extracted automatically from SSE request headers - - Communicates with FastAPI backend, no direct database access - - No session management, fully scalable - - Optimized async HTTP client (httpx) - - show_* tools return data formatted for native mobile components - - Includes voice_summary for TTS in chat applications - - get_* for internal data processing, show_* to trigger UI updates The MCP server provides organized into 3 categories. All tools require JWT authentication via SSE Authorization header. Tools follow a dual pattern: get_* returns raw data for model reasoning, show_* triggers UI rendering in the mobile app.

README

Показан фрагмент оригинального README. Открыть оригинал.

MyTaskly MCP Server

Model Context Protocol (MCP) server for MyTaskly with OAuth 2.1 JWT authentication and seamless integration with the FastAPI backend.

📋 Key Features

🔐 Enterprise-Grade Authentication

OAuth 2.1 JWT - Token-based authentication following MCP 2025 standards (RFC 8707)
SSE Transport - Server-Sent Events for HTTP-based deployment (Railway-ready)
Context-Based Auth - Token extracted automatically from SSE request headers

🚀 High-Performance Integration

HTTP API Gateway - Communicates with FastAPI backend, no direct database access
Stateless Architecture - No session management, fully scalable
Connection Pooling - Optimized async HTTP client (httpx)

📱 Mobile-First Design

React Native Optimized - show_* tools return data formatted for native mobile components
Voice-Friendly Responses - Includes voice_summary for TTS in chat applications
Dual-Mode Tools - get_* for internal data processing, show_* to trigger UI updates

🛠️ Available MCP Tools (18 Active)

The MCP server provides 18 active tools organized into 3 categories. All tools require JWT authentication via SSE Authorization header.

Tools follow a dual pattern: get_* returns raw data for model reasoning, show_* triggers UI rendering in the mobile app.

📋 Task Tools (8)

Tool	Description
`get_tasks`	Get tasks with filters — for internal model use (raw data)
`add_task`	Create a new task with smart category lookup
`update_task`	Update one or more fields of an existing task
`complete_task`	Quick shortcut to mark a task as completed
`get_task_stats`	Get aggregate statistics by status, priority, and category
`get_overdue_tasks`	Get all overdue pending tasks
`get_upcoming_tasks`	Get tasks due in the next N days
`show_tasks_to_user`	Display task list in the mobile app UI

Example Response — get_tasks:

{
  "tasks": [
    {
      "task_id": 123,
      "title": "Pizza",
      "description": "Ordinare pizza margherita",
      "end_time": "2025-12-15T18:00:00",
      "start_time": null,
      "priority": "Alta",
      "status": "In sospeso",
      "category_id": 5,
      "duration_minutes": 30
    }
  ],
  "total": 10
}

Example Response — add_task (success):