MM

mytaskly/mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

2 stars 0 forks 质量 51 趋势 8

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):

{
  "success": true,
  "task_id": 124,
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →