Skip to main content
Glama
Functional Requirements MCP Server

Functional Requirements MCP Server

by xTr161

Functional Requirements MCP Server

A Model Context Protocol (MCP) server that provides AI-powered prompts for generating user stories, requirements, technical specifications, and other software development documentation.

๐ŸŽฏ Overview

This MCP server offers a collection of specialized prompts designed to streamline the software development lifecycle by automating the creation of structured documentation. It focuses on functional requirements analysis and technical documentation generation.

Related MCP server: MCP Documentation Server

โœจ Features

Core Functionality

  • User Story Creation: Generate detailed user stories with proper formatting and structure

  • Requirements Generation: Convert user stories into functional and non-functional requirements

  • Technical Specifications: Transform requirements into detailed technical documentation

  • Meeting Documentation: Extract action items and decisions from meeting notes

  • Release Notes: Create professional release documentation

  • Architecture Decision Records (ADRs): Document technical decisions and rationale

Structured Data Models

  • UserStory Model: Comprehensive data structure with MoSCoW prioritization

  • Step-by-Step Processes: Support for normal and exceptional flow documentation

  • Actor Management: Track stakeholders and system users

๐Ÿš€ Quick Start

Prerequisites

  • Python 3.13 or higher

  • uv package manager

  • Claude Desktop or compatible MCP client

Installation

  1. Clone the repository:

    git clone <repository-url>
    cd Coding_MCP
  2. Install dependencies:

    uv sync
  3. Configure Claude Desktop: Add this server configuration to your claude_desktop_config.json:

    {
      "mcpServers": {
        "Functional Requirements": {
          "command": "C:\\Users\\<your-username>\\AppData\\Local\\Programs\\Python\\Python311\\Scripts\\uv.EXE",
          "args": [
            "run",
            "--with",
            "mcp[cli]",
            "mcp",
            "run",
            "C:\\Users\\<your-username>\\source\\repos\\Coding_MCP\\main.py"
          ]
        }
      }
    }
  4. Restart Claude Desktop to load the new server.

๐Ÿ“– Usage Guide

Available Prompts

1. Create User Story

Purpose: Generate structured user stories from contextual information.

Usage: Provide context about a feature or requirement, and the prompt will create a properly formatted user story following the "As a [actor], I want [feature] so that [benefit]" convention.

Output: JSON-structured user story with:

  • Unique identifier and name

  • Definition following user story conventions

  • Pre/post conditions

  • Actors involved

  • Normal and exceptional process flows

  • MoSCoW prioritization with explanation

  • Related requirements

2. Create Requirements

Purpose: Transform user stories into detailed functional and non-functional requirements.

Input: UserStory object Output: Comprehensive requirements covering:

  • Functional requirements (system capabilities)

  • Non-functional requirements (performance, security, usability)

  • Technical constraints and dependencies

  • Acceptance criteria for testing

3. Technical Specification Writer

Purpose: Convert requirements into detailed technical specifications.

Output Structure:

  • Overview and Scope

  • System Architecture

  • Detailed Design (APIs, data models, database design)

  • Implementation Details

  • Integration Points

  • Quality Attributes

4. Meeting Summary Generator

Purpose: Extract structured information from meeting notes.

Output Includes:

  • Key decisions made

  • Action items with owners and due dates

  • Discussion points and open questions

  • Next steps and dependencies

  • Parking lot items

5. Release Notes Creator

Purpose: Generate professional, user-facing release documentation.

Sections Include:

  • What's New (features and enhancements)

  • Improvements (performance, UX, developer experience)

  • Bug Fixes

  • Security Updates

  • Breaking Changes with migration guides

  • Technical details and acknowledgments

6. Architecture Decision Record (ADR)

Purpose: Document technical decisions with proper rationale.

Structure:

  • Status and decision makers

  • Context and problem statement

  • Options considered with pros/cons

  • Decision rationale

  • Implementation plan

  • Consequences and risks

  • Compliance considerations

๐Ÿ—๏ธ Project Structure

Coding_MCP/
โ”œโ”€โ”€ main.py                 # MCP server with prompt definitions
โ”œโ”€โ”€ pyproject.toml         # Project configuration and dependencies
โ”œโ”€โ”€ uv.lock               # Dependency lock file
โ”œโ”€โ”€ models/
โ”‚   โ”œโ”€โ”€ user_story.py     # UserStory and Step data models
โ”‚   โ””โ”€โ”€ requirements.py   # Requirements-related models
โ”œโ”€โ”€ prompts/              # (Future: Additional prompt templates)
โ””โ”€โ”€ __pycache__/         # Python bytecode cache

๐Ÿ”ง Development

Local Development Setup

  1. Activate the virtual environment:

    uv venv
    .venv\Scripts\activate
  2. Install in development mode:

    uv pip install -e .
  3. Run the server directly (for testing):

    uv run python main.py

Testing the Server

You can test individual prompts by running the server locally and using the MCP client tools:

# Run the server
uv run mcp run main.py

# In another terminal, test prompts
uv run mcp call main.py prompts/list

Adding New Prompts

  1. Define your prompt function in main.py:

    @mcp.prompt(title="your prompt title", description="Description of what it does")
    def your_prompt_function(input_parameter: str) -> str:
        return f"""Your prompt template here with {input_parameter}"""
  2. Follow the established patterns for structured output and clear instructions.

  3. Test your prompt thoroughly before deployment.

๐Ÿ“Š Data Models

UserStory Model

The UserStory class provides a comprehensive structure for capturing user requirements:

class UserStory(BaseModel):
    id: str                           # Unique identifier
    name: str                         # Concise title
    definition: str                   # "As a..., I want..., so that..."
    pre_condition: Optional[str]      # Required state before execution
    post_condition: Optional[str]     # Expected state after completion
    actors: List[str]                 # Involved stakeholders
    normal_flow: List[Step]           # Happy path steps
    exceptional_flows: List[Step]     # Error/alternative paths
    moscow: MoSCoW                    # Priority (Must/Should/Could/Won't Have)
    moscow_explanation: Optional[str] # Priority rationale
    requirements: List[str]           # Related requirement references

Step Model

For process flow documentation:

class Step(BaseModel):
    id: str      # Step identifier (e.g., "1", "2a", "3b")
    action: str  # Description of what happens

๐Ÿ”’ Security Considerations

  • The server processes text input only - no file system access

  • All prompts generate documentation, not executable code

  • Input validation is handled by Pydantic models

  • No external API calls or network access required

๐Ÿค Contributing

  1. Fork the repository

  2. Create a feature branch: git checkout -b feature/new-prompt

  3. Add your changes and tests

  4. Commit with clear messages: git commit -m "Add new prompt for..."

  5. Push and create a pull request

Code Style

  • Follow PEP 8 for Python code

  • Use type hints for all function parameters and returns

  • Add docstrings for new models and complex functions

  • Maintain consistent prompt formatting and structure

๐Ÿ“„ License

[Add your license information here]

๐Ÿ†˜ Troubleshooting

Common Issues

Server not appearing in Claude Desktop:

  • Verify the path in claude_desktop_config.json is correct

  • Ensure uv is installed and accessible

  • Check that Python 3.11+ is installed

  • Restart Claude Desktop after configuration changes

Import errors:

  • Run uv sync to ensure all dependencies are installed

  • Verify you're using Python 3.11 or higher

Prompt not working as expected:

  • Check the prompt formatting and structure

  • Ensure input parameters match the expected types

  • Review the output for any parsing errors

Getting Help

  • Check the MCP documentation

  • Review existing prompt implementations in main.py

  • Create an issue for bugs or feature requests

๐Ÿ”ฎ Future Enhancements

  • Additional prompt templates for specific domains

  • Integration with project management tools

  • Export capabilities for generated documentation

  • Batch processing for multiple user stories

  • Custom template support

  • Integration with version control systems


Made with โค๏ธ for better software documentation

Available Tools

8 tools
create_task create taskC

Create a new task in the task repo system.

Inputs: task (required). Returns: This model can be used to validate and serialize task data in a task managementโ€ฆ

create_user_storycreate user storyC

Create a structured user story based on provided context

Inputs: user_story (required). Returns: Encapsulates all the structured data for a user story / useโ€case.

delete_taskdelete taskC
Destructive

Delete a task from the task repo system.

Inputs: uuid (required).

generate_requirementsgenerate requirementsC
Idempotent

Generate structured requirements from a user story

Inputs: request (required). Returns: result

get_requirementsget requirementsB
Read-onlyIdempotent

Retrieve all stored requirements

Inputs: no named parameters. Returns: result

get_tasks_toolget tasksC
Read-onlyIdempotent

Retrieve all tasks from the task repo system.

Inputs: parentId. Returns: result

get_user_storiesget user storiesB
Read-onlyIdempotent

Retrieve all stored user stories

Inputs: no named parameters. Returns: result

update_task_statusupdate taskC

Update an existing task in the task repo system.

Inputs: uuid (required), status (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    B3.1/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: user stories (create/get), requirements (generate/get), and tasks (create/get/update status/delete). There is no overlap or ambiguity between any pair of tools.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern in snake_case (create_user_story, get_user_stories, create_task, etc.). The tool 'get_tasks_tool' deviates by appending a redundant '_tool' suffix, which is a minor inconsistency.

    Tool Count5/5

    Eight tools are well-scoped for managing user stories, requirements, and tasks. Each tool has a clear purpose and the count fits comfortably within the typical 3-15 range.

    Completeness3/5

    The server covers create and retrieve for user stories and requirements, and partial CRUD for tasks, but lacks update/delete operations for user stories and requirements, as well as task retrieval by ID or full task updates. These notable gaps limit lifecycle coverage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers