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.0.0.tar.gz (14.7 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.0.0-py3-none-any.whl (11.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: onlynet_tasks-1.0.0.tar.gz
  • Upload date:
  • Size: 14.7 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.0.0.tar.gz
Algorithm Hash digest
SHA256 135b3d96d00b00d009406727b19690a878e74bd0d3e3fe1aa42c296a39e04189
MD5 8154b154e7538218701238a38e166cd6
BLAKE2b-256 f9cd6196e266933a5ca14d44cad6cdd896e9022b0d31a45fe39cd7645e16aeb4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: onlynet_tasks-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 11.7 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.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ed181dc308d790aa1bb618627cd4adee5114df90304ed93b1e8adf95ae352f9d
MD5 78a81b3a4471e515fd735d25d659f0f0
BLAKE2b-256 8c809cc99e56f3c712f295cfee6076cd64ec8ab6b9b51efdf84d4ec3f9a00c37

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