Skip to main content

MCP server for PRD generation and task management with Cursor agents

Project description

OnlyNet Tasks MCP Server

PyPI version Python 3.8+ License: MIT

A powerful Model Context Protocol (MCP) server for generating Product Requirements Documents (PRDs) and creating intelligent task breakdowns with complexity assessment. Designed specifically for integration with Cursor agents and development workflows.

Features

  • 📋 PRD Generation: Interactive PRD creation with guided questions covering all project aspects
  • 🎯 Intelligent Task Breakdown: Automatic generation of tasks from PRD analysis with proper complexity assessment
  • 📊 Complexity Levels: 4-level complexity system (0: Very easy, 1: Easy, 2: Complex, 3: Senior level)
  • 🔗 Dependency Management: Automatic task dependency detection and workflow organization
  • 📂 Smart Directory Detection: Intelligent project directory detection for seamless integration
  • 🎮 Cursor Integration: Native support for Cursor agent workflows

Installation

Install directly from PyPI:

pip install onlynet-tasks

Quick Start

1. Configure Cursor MCP Settings

Add the following to your Cursor MCP settings:

{
  "mcpServers": {
    "onlynet-tasks": {
      "command": "onlynet-tasks",
      "env": {
        "ONLYNET_DATA_DIR": "/absolute/path/to/your/project"
      }
    }
  }
}

Or for auto-detection (recommended):

{
  "mcpServers": {
    "onlynet-tasks": {
      "command": "onlynet-tasks"
    }
  }
}

2. Start Using

Once configured, you can interact with the server through Cursor:

  1. Generate PRD: Create a comprehensive Product Requirements Document
  2. Create Tasks: Generate intelligent task breakdown from PRD
  3. Manage Tasks: Read, update, and complete tasks as you progress

Available Tools

Tool Description
generate_prd Create PRD with guided questions
update_prd Update PRD sections with answers
create_tasks_from_prd Generate tasks from PRD analysis
read_task Read specific task or get next open task
complete_task Mark task as completed
list_all_tasks List all tasks with status

Complexity Levels

Tasks are automatically assigned complexity levels based on intelligent analysis:

  • Level 0: Very easy task (basic setup, documentation)
  • Level 1: Easy task (simple implementations, basic features)
  • Level 2: Complex task (advanced features, integrations)
  • Level 3: Senior developer level (architecture, complex algorithms)

Example Workflow

# 1. Generate PRD for your project
"Generate PRD for a task management app"

# 2. Create task breakdown
"Create tasks from the PRD"

# 3. Work through tasks
"Show me the next open task"
"Complete task TASK-001-01"
"List all tasks to see progress"

Directory Configuration

The server automatically detects the project directory using these methods:

  1. Environment Variable: ONLYNET_DATA_DIR (if set)
  2. Auto-detection: Searches for project indicators (.git, package.json, etc.)
  3. Current Directory: Falls back to current working directory

The detection happens automatically when you first use any tool - no manual configuration needed!

Integration Examples

Cursor Configuration

{
  "mcpServers": {
    "onlynet-tasks": {
      "command": "onlynet-tasks",
      "env": {
        "ONLYNET_DATA_DIR": "/home/user/projects/my-app"
      }
    }
  }
}

Direct Usage

# Run the server directly
onlynet-tasks

# Or with Python module syntax
python -m onlynet_tasks.server

File Structure

The server creates the following files in your project directory:

project/
├── onlynet/
│   ├── prd.md              # Generated PRD
│   └── tasks.json          # Task breakdown and status

Requirements

  • Python 3.8 or higher
  • FastMCP 2.7.0 or higher
  • Pydantic 2.0.0 or higher

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues and questions:


Made with ❤️ for the development community

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

onlynet_tasks-1.2.0.tar.gz (16.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

onlynet_tasks-1.2.0-py3-none-any.whl (13.3 kB view details)

Uploaded Python 3

File details

Details for the file onlynet_tasks-1.2.0.tar.gz.

File metadata

  • Download URL: onlynet_tasks-1.2.0.tar.gz
  • Upload date:
  • Size: 16.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for onlynet_tasks-1.2.0.tar.gz
Algorithm Hash digest
SHA256 e2fa173f2720f5860d2e03f25987380bf8cff7374fc49cb8a6c7ebfe5a97f0d5
MD5 ff5b071a0a6329f78ce8e27f7c70546c
BLAKE2b-256 c2d2181c157988e659a026c94892692b1d893adb7db0378617c794e049f9bf39

See more details on using hashes here.

File details

Details for the file onlynet_tasks-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: onlynet_tasks-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 13.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for onlynet_tasks-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a93a12c09d2aa569477c4d856f6e5c3fda7b6ef8229f427c5d90257b271a73f6
MD5 91a63aa3ea1757833be59925805f45dc
BLAKE2b-256 f6391fd535e2a909b45a756a10bb6a4806890b955d29cd92d5530740cb0a0644

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page