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
set_project_directory Set custom project directory

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 supports multiple ways to determine the project directory:

  1. Environment Variable: ONLYNET_DATA_DIR
  2. Auto-detection: Searches for project indicators (.git, package.json, etc.)
  3. Manual Setting: Use set_project_directory tool
  4. Current Directory: Falls back to current working directory

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.1.0.tar.gz (16.3 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.1.0-py3-none-any.whl (13.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: onlynet_tasks-1.1.0.tar.gz
  • Upload date:
  • Size: 16.3 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.1.0.tar.gz
Algorithm Hash digest
SHA256 539f366fe3c5c15235ef2b68f8e95fe35d0887f34066b8576d7937ff4ba9deff
MD5 6ffdb8e5a5bf3aef69ed51704b97f39b
BLAKE2b-256 10a2b8814adf9eae412e3e3c5792a3489cc6f91eb077620e7c6d8b252a2d5c49

See more details on using hashes here.

File details

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

File metadata

  • Download URL: onlynet_tasks-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 13.2 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3e1042230e4b2cb511a7bd1a8aacbcd15b44f0895f2673f410c420bb4e559af1
MD5 f4bb37803e968a87b22b3513194cb911
BLAKE2b-256 33b9adde2e53c58585ad5c8c211fb3637e6439dba69e66cac2c1c07b39237929

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