Thinking Patterns MCP Server


📖 Documentation Index

- SUMMARY.md - Executive summary and quick overview
- SYSTEM_INTENT.md - Deep dive into the system's purpose and philosophy
- TECHNICAL_ARCHITECTURE.md - Technical implementation details and design patterns
- README.md - This file: comprehensive usage guide and examples

---

A comprehensive Model Context Protocol (MCP) server that combines systematic thinking, mental models, debugging approaches, and stochastic algorithms for enhanced problem-solving capabilities. This server merges the functionality of Clear Thought and Stochastic Thinking servers into a unified cognitive toolkit.

Features

$3


$3

1. sequential_thinking - Dynamic multi-step thinking with revision support
1. mental_model - Structured mental models for problem-solving
1. debugging_approach - Systematic debugging methodologies
1. collaborative_reasoning - Multi-perspective collaborative problem solving
1. decision_framework - Structured decision analysis and rational choice
1. metacognitive_monitoring - Self-assessment of knowledge and reasoning quality
1. scientific_method - Formal hypothesis testing and experimentation
1. structured_argumentation - Dialectical reasoning and argument analysis
1. visual_reasoning - Diagram-based thinking and problem solving
1. domain_modeling - Creating and refining conceptual models of a domain
1. problem_decomposition - Breaking down complex problems into manageable sub-problems
1. critical_thinking - Systematic evaluation of arguments, assumptions, and potential issues
1. recursive_thinking - Applying recursive strategies to solve problems with base and recursive cases
1. temporal_thinking - Modeling systems and reasoning across time using states, events, and transitions in both text and diagrams
1. stochastic_algorithm - Probabilistic algorithms for decision-making under uncertainty
- Markov Decision Processes: Sequential decision-making with clear state transitions and defined rewards.
- Monte Carlo Tree Search: Game playing, strategic planning, large decision spaces where simulation is possible.
- Multi-Armed Bandit: A/B testing, resource allocation, online advertising, quick adaptation needs.
- Bayesian Optimization: Hyperparameter tuning, expensive function optimization, continuous parameter spaces.
- Hidden Markov Models: Time series analysis, pattern recognition, state inference, sequential data modeling.

Recommended

- sequential-thinking & problem-decomposition are classic choices for planning.
- debugging-approach for runtime investigations; try sending it an error message from a test run.
- collaborative-reasoning often reveals issues or anti-patterns by simulating multiple roles who all must arrive at a consensus.
- temporal-thinking automatically generates Mermaid sequence diagrams from state transitions - perfect for visualizing user flows, API interactions, and system processes.

Installation

$3

To install Thinking Patterns MCP Server for Cursor automatically via Smithery:

``bash
npx -y @smithery/cli install @emmahyde/thinking-patterns --client cursor
`

$3


`bash
npm install @emmahyde/thinking-patterns
`

Or run with npx:

`bash
npx -y @emmahyde/thinking-patterns
`

$3

Build the Docker image:

`bash
docker build -t emmahyde/thinking-patterns .
`

Run the container:

`bash
docker run -it emmahyde/thinking-patterns
`

$3

1. Clone the repository
2. Install dependencies: npm install
3. Build the project: npm run build
4. Start the server: npm start

$3


`json
{
"mcpServers": {
"thinking-patterns": {
"command": "npx",
"args": ["-y", "@emmahyde/thinking-patterns"]
}
}
}
`

Real-World Usage Examples for Rails, Ruby & React Developers

$3

`ruby

Planning a multi-tenant Rails API with complex authentication

const response = await mcp.callTool("sequential_thinking", {
thought: "Building multi-tenant Rails API. Need to implement row-level security with Postgres RLS. Current: single-tenant monolith with 50k users. Target: support 500 organizations with data isolation.",
thoughtNumber: 1,
totalThoughts: 4,
nextThoughtNeeded: true,
currentStep: {
stepDescription: "Design database schema for multi-tenancy using Postgres schemas vs shared tables with tenant_id",
recommendedTools: [
{
toolName: "domain_modeling",
confidence: 0.9,
rationale: "Need to model tenant boundaries and data relationships",
priority: 1
}
],
expectedOutcome: "Clear multi-tenant database architecture with migration path",
nextStepConditions: ["Schema design validated", "Performance implications understood"]
}
});
`

$3

`typescript
// Using composition patterns to solve prop drilling in React
const response = await mcp.callTool("mental_model", {
modelName: "Component Composition",
problem: "React app with 8-level deep prop drilling for user auth state. Components tightly coupled, hard to test. Need to refactor without adding Redux complexity.",
steps: [
"Identify leaf components actually using auth state: UserAvatar, ProtectedRoute, ProfileMenu",
"Create AuthProvider using Context API with useAuth hook",
"Implement compound components pattern for related UI: ",
"Use component composition to eliminate intermediate prop passing"
],
reasoning: "Composition over inheritance principle. Context for cross-cutting concerns, compound components for related UI elements. Avoids Redux overhead for simple auth state.",
conclusion: "Implement AuthContext with provider pattern, refactor to compound components. Reduces coupling from 8 levels to direct consumption. Testing simplified with mock providers."
});
`

$3

`ruby

Systematic debugging of performance degradation in Rails app

const response = await mcp.callTool("debugging_approach", {
approachName: "Performance Profiling",
issue: "Rails API endpoint timeout after deploy. /api/v1/projects endpoint went from 200ms to 8s response time. Affects project dashboard loading.",
classification: {
category: "performance",
severity: "critical",
priority: "urgent",
impact: "user-facing",
frequency: "always"
},
steps: [
"Add bullet gem to detect N+1 queries in development",
"Enable Rails query logging with explain analyze",
"Profile with rack-mini-profiler to identify slow queries",
"Check recent commits for association changes"
],
hypotheses: [
{
statement: "New project.collaborators association missing includes() causing N+1",
confidence: 0.85,
status: "confirmed",
testPlan: "Compare SQL logs before/after adding .includes(:collaborators, :tags)"
}
],
findings: "ProjectsController#index loading collaborators individually for 200 projects. Missing includes(:collaborators, user: :profile) in query.",
resolution: "Added .includes(:collaborators, :tags, user: :profile). Response time reduced to 180ms. Added test to prevent regression."
});
`

$3

`typescript
// Progressive feature rollout using multi-armed bandit
const response = await mcp.callTool("stochastic_algorithm", {
algorithm: "Multi-Armed Bandit",
problem: "Roll out new React checkout flow to minimize risk. Current flow: 3.2% conversion. New flow: unknown performance. Need safe rollout strategy for 100k daily users.",
parameters: {
"epsilon": "0.15",
"variants": "2",
"success_metric": "checkout_completion_rate",
"minimum_sample": "1000"
},
result: "Thompson Sampling implementation: Start with 5% traffic. After 2k users: new flow showing 3.8% conversion (95% CI: 3.5-4.1%). Algorithm automatically increased to 35% traffic. Full rollout recommended after 10k samples."
});
`

$3

`typescript
// Multi-perspective analysis of monolith decomposition
const response = await mcp.callTool("collaborative_reasoning", {
topic: "Extract payment processing from Rails monolith to separate service. Current: 500k LOC monolith, payment logic intertwined with order management.",
personas: [
{
id: "rails_architect",
name: "Senior Rails Developer",
expertise: ["Rails patterns", "Active Record", "service objects"],
background: "10 years Rails, maintained large monoliths",
perspective: "Pragmatic extraction with minimal disruption",
biases: ["Rails way preference", "skeptical of microservices"],
communication: { style: "practical", tone: "cautious" }
},
{
id: "sre",
name: "Site Reliability Engineer",
expertise: ["distributed systems", "observability", "deployment"],
background: "Managed microservices at scale",
perspective: "Operational complexity and reliability",
biases: ["over-emphasis on monitoring", "complexity aversion"],
communication: { style: "data-driven", tone: "analytical" }
}
],
contributions: [
{
personaId: "rails_architect",
content: "Start with Strangler Fig pattern. Extract PaymentService class first, then move to engine, finally separate app. Database can stay shared initially with payment_* tables.",
type: "proposal",
confidence: 0.8
},
{
personaId: "sre",
content: "Need distributed tracing before extraction. Shared database is anti-pattern - plan for event sourcing or sync strategy. What about payment failure rollbacks?",
type: "concern",
confidence: 0.9
}
],
stage: "synthesis",
activePersonaId: "rails_architect",
sessionId: "payment-extraction-2024",
iteration: 3,
nextContributionNeeded: true
});
`

$3

`typescript
// Choosing state management solution for growing React app
const response = await mcp.callTool("decision_framework", {
decisionStatement: "Select state management for React e-commerce app. Currently prop drilling with 50+ components. Need: cart state, user auth, product catalog, UI state.",
options: [
{ name: "Redux Toolkit", description: "Official Redux with modern patterns" },
{ name: "Zustand", description: "Lightweight alternative with simple API" },
{ name: "Context + useReducer", description: "Built-in React solution" },
{ name: "Valtio", description: "Proxy-based state with mutable API" }
],
analysisType: "multi-criteria",
criteria: [
{
name: "Learning Curve",
description: "Time for team to become productive",
weight: 0.25,
evaluationMethod: "qualitative"
},
{
name: "Bundle Size",
description: "Impact on app performance",
weight: 0.2,
evaluationMethod: "quantitative"
},
{
name: "DevX",
description: "Developer experience and tooling",
weight: 0.3,
evaluationMethod: "qualitative"
},
{
name: "Type Safety",
description: "TypeScript support and type inference",
weight: 0.25,
evaluationMethod: "qualitative"
}
],
stage: "evaluation",
decisionId: "state-mgmt-2024",
iteration: 1,
nextStageNeeded: true
});
`

$3

`ruby

Self-assessment during critical performance optimization

const response = await mcp.callTool("metacognitive_monitoring", {
task: "Optimize Ruby background job processing. Current: 1k jobs/minute, target: 10k jobs/minute. Using Sidekiq with Redis, seeing Redis connection pool exhaustion.",
stage: "execution",
overallConfidence: 0.7,
knowledgeAssessment: {
domain: "Ruby Concurrency and Sidekiq Optimization",
knowledgeLevel: "intermediate",
confidenceScore: 0.7,
supportingEvidence: "Optimized Sidekiq at previous job, familiar with Redis patterns",
knownLimitations: ["Haven't worked with connection pooling at this scale", "Limited experience with Redis Cluster"]
},
claims: [
{
claim: "Connection pool size is the bottleneck",
status: "hypothesis",
confidenceScore: 0.8,
evidenceBasis: "Redis TIME_WAIT connections growing, pool size still at default 5"
},
{
claim: "Jobs can be batched to reduce Redis round trips",
status: "uncertain",
confidenceScore: 0.6,
evidenceBasis: "Many jobs are independent SMS sends, but unsure about batching impact on latency"
}
],
uncertaintyAreas: ["Optimal connection pool size for our workload", "Impact of job batching on delivery SLAs"],
recommendedApproach: "Increase pool size incrementally while monitoring Redis CPU. Prototype job batching with small subset to measure latency impact.",
monitoringId: "sidekiq-optimization-2024",
iteration: 1,
nextAssessmentNeeded: true
});
`

$3

`typescript
// Testing hypothesis about React re-render optimization
const response = await mcp.callTool("scientific_method", {
stage: "experiment",
observation: "Product list page with 500 items has 2s interaction delay when filtering. React DevTools shows all items re-rendering on every filter change.",
question: "Will React.memo and useMemo reduce re-renders and improve filter performance?",
hypothesis: {
statement: "Memoizing ProductCard components and filter calculations will reduce re-render time by 80%",
variables: [
{
name: "memoization_strategy",
type: "independent",
operationalization: "React.memo on ProductCard, useMemo for filtered items array"
},
{
name: "interaction_delay",
type: "dependent",
operationalization: "Time between filter click and UI update, measured via Performance API"
}
],
assumptions: ["ProductCard props are mostly stable", "Filter calculation is expensive", "Re-renders are the primary bottleneck"],
hypothesisId: "react-perf-2024",
confidence: 0.8,
domain: "Frontend Performance",
iteration: 1,
status: "testing"
},
experiment: {
design: "Before/after comparison",
methodology: "Implement memoization, measure with React Profiler and Performance API",
predictions: [
{
if: "ProductCard wrapped in React.memo with proper prop comparison",
then: "Only filtered items will re-render, reducing render time from 2000ms to 400ms",
else: "All items continue to re-render"
}
],
controlMeasures: ["Same dataset", "Same testing device", "Production build"],
experimentId: "memo-optimization-test",
hypothesisId: "react-perf-2024"
},
inquiryId: "react-performance-study",
iteration: 1,
nextStageNeeded: true
});
`

$3

`ruby

Arguing for Rails version upgrade

const response = await mcp.callTool("structured_argumentation", {
claim: "We should upgrade from Rails 6.1 to Rails 7.1 this quarter despite feature pressure",
premises: [
"Rails 6.1 security support ends in 6 months",
"Rails 7.1 offers 40% performance improvement in Active Record",
"Current tech debt interest: 20% of sprint capacity",
"Upgrade estimated at 3 sprints with full test coverage",
"New features delayed by old Rails version: native ES6 modules, Hotwire"
],
conclusion: "Rails upgrade is critical for security, performance, and developer productivity. Delaying increases risk and technical debt exponentially.",
argumentType: "risk-mitigation",
confidence: 0.9,
strengths: [
"Clear security deadline creates urgency",
"Performance gains directly impact user experience and costs",
"Enables modern features blocking current development"
],
weaknesses: [
"3 sprints of feature development postponed",
"Gem compatibility might require additional work",
"Team needs upskilling on Rails 7 features"
],
nextArgumentNeeded: false
});
`

$3

`typescript
// Analyzing component hierarchy for optimization
const response = await mcp.callTool("visual_reasoning", {
operation: "analyze",
diagramId: "react-component-tree-2024",
diagramType: "tree-diagram",
purpose: "Identify prop drilling and unnecessary re-renders in checkout flow",
elements: [
{
id: "app-root",
type: "node",
label: "App",
properties: {
position: { x: 400, y: 50 },
style: { color: "blue", size: "large" },
semantics: { rerenders: "frequently", props: ["user", "cart", "theme"] }
},
connectedTo: ["checkout-page", "header", "footer"]
},
{
id: "checkout-page",
type: "node",
label: "CheckoutPage",
properties: {
position: { x: 400, y: 150 },
style: { color: "orange", size: "large" },
semantics: { rerenders: "frequently", props: ["user", "cart", "updateCart"] }
},
connectedTo: ["cart-summary", "payment-form", "shipping-form"]
},
{
id: "cart-summary",
type: "node",
label: "CartSummary",
properties: {
position: { x: 200, y: 250 },
style: { color: "red", size: "medium" },
semantics: { rerenders: "very-frequently", props: ["cart", "updateCart"] }
}
}
],
observation: "CartSummary re-renders on every form input change due to cart object reference changing",
insight: "Implementing React.memo and splitting cart state (items vs metadata) could eliminate 80% of re-renders",
transformationType: "optimization",
transformationDetails: {
target: ["cart-summary", "checkout-page"],
rationale: "Separate cart items from cart metadata, memoize expensive calculations",
parameters: { "pattern": "state-splitting", "optimization": "React.memo" }
},
iteration: 1,
nextOperationNeeded: true
});
`

$3

`ruby

Modeling complex e-commerce domain in Rails

const response = await mcp.callTool("domain_modeling", {
domainName: "Multi-vendor Marketplace",
description: "Rails application supporting multiple vendors, commission structures, inventory tracking, and payment splitting",
entities: [
{
name: "Vendor",
description: "Seller account with inventory and payment details",
attributes: ["id", "shop_name", "commission_rate", "stripe_account_id", "status"],
behaviors: ["calculate_payout", "update_inventory", "process_refund"],
constraints: ["Commission rate between 5-30%", "Must have verified Stripe account", "Unique shop_name"]
},
{
name: "Product",
description: "Item listed by vendor with variants and inventory",
attributes: ["id", "vendor_id", "name", "base_price", "inventory_count"],
behaviors: ["check_availability", "reserve_inventory", "calculate_vendor_price"],
constraints: ["Belongs to one vendor", "Price must be positive", "Inventory non-negative"]
},
{
name: "Order",
description: "Customer purchase potentially spanning multiple vendors",
attributes: ["id", "customer_id", "total_amount", "status", "placed_at"],
behaviors: ["split_by_vendor", "calculate_commissions", "process_payments"],
constraints: ["Must have at least one item", "Status transitions are one-way"]
}
],
relationships: [
{
name: "sells",
type: "one-to-many",
sourceEntity: "Vendor",
targetEntity: "Product",
description: "Vendor sells multiple products",
cardinality: "1..*",
implementation: "has_many :products, dependent: :restrict_with_error"
},
{
name: "contains_items_from",
type: "many-to-many",
sourceEntity: "Order",
targetEntity: "Vendor",
description: "Order can contain products from multiple vendors",
cardinality: "..",
implementation: "has_many :vendors, through: :order_items"
}
],
domainRules: [
{
name: "Commission Calculation",
description: "Platform commission deducted from vendor payout on successful delivery",
type: "business-rule",
entities: ["Order", "Vendor"],
condition: "Order transitions to 'delivered' status",
consequence: "Calculate vendor_payout = item_total * (1 - vendor.commission_rate)",
implementation: "after_transition to: :delivered, do: :calculate_vendor_payouts"
}
],
stage: "implementation",
abstractionLevel: "detailed",
paradigm: "active-record",
modelingId: "marketplace-domain-2024",
iteration: 2,
nextStageNeeded: true
});
`

$3

`typescript
// Breaking down offline-first React Native feature
const response = await mcp.callTool("problem_decomposition", {
problem: "Implement offline-first React Native app for field technicians. Must sync work orders, capture photos, work without internet for days. 50+ technicians in rural areas.",
decomposition: [
{
id: "local-storage",
description: "Implement SQLite with TypeORM for local data persistence",
category: "infrastructure",
complexity: "high",
priority: "critical",
effortEstimate: "2 weeks",
dependencies: [],
acceptanceCriteria: [
{
description: "Store 1000+ work orders with photos locally",
measurable: true,
priority: "must-have",
testable: true
},
{
description: "Queue updates for sync when online",
measurable: true,
priority: "must-have",
testable: true
}
],
risks: [
{
description: "SQLite performance with large photo blobs",
probability: 0.4,
impact: "high",
category: "technical",
mitigation: "Store photos in filesystem, references in DB"
}
]
},
{
id: "sync-engine",
description: "Build bidirectional sync with conflict resolution",
category: "feature",
complexity: "very-high",
priority: "critical",
effortEstimate: "3 weeks",
dependencies: ["local-storage"],
acceptanceCriteria: [
{
description: "Handle concurrent edits with last-write-wins strategy",
measurable: true,
priority: "must-have",
testable: true
}
]
},
{
id: "offline-ui",
description: "UI indicators for sync status and offline mode",
category: "user-experience",
complexity: "medium",
priority: "high",
effortEstimate: "1 week",
dependencies: ["sync-engine"],
stakeholders: [
{
name: "Field Operations Manager",
role: "primary-user",
influence: "high",
interest: "high"
}
]
}
],
methodology: "Bottom-up Implementation",
objectives: ["MVP in 6 weeks", "Support 1 week offline operation", "Sync within 2 minutes on connection"]
});
`

$3

`ruby

Critical analysis of authentication gem choice

const response = await mcp.callTool("critical_thinking", {
subject: "Choosing between Devise, Clearance, and custom auth for new Rails API. API-only, JWT tokens needed, 100k+ users expected.",
potentialIssues: [
{
description: "Devise is overkill for API-only auth, includes unnecessary view layers",
severity: "medium",
category: "architectural",
likelihood: 0.8,
mitigation: "Use devise-jwt extension or consider lighter alternatives"
},
{
description: "Custom auth risks security vulnerabilities without expert review",
severity: "critical",
category: "security",
likelihood: 0.6,
mitigation: "If custom, use has_secure_password and follow OWASP guidelines"
}
],
edgeCases: [
{
scenario: "JWT token refresh during high-traffic periods",
conditions: ["Multiple simultaneous refresh requests", "Redis connection failures"],
currentBehavior: "Devise-jwt doesn't handle concurrent refresh well",
expectedBehavior: "Atomic token refresh with race condition handling",
testability: "high",
businessImpact: "high"
}
],
invalidAssumptions: [
{
statement: "JWT is always better than sessions for API auth",
validity: "contextual",
verification: "Consider session storage for internal APIs, JWT for mobile/external",
consequences: "JWT can't be revoked easily, larger payload size"
},
{
statement: "Popular gems are always more secure",
validity: "questionable",
verification: "Review gem's issue tracker and security advisories",
dependencies: ["Gem maintenance status", "Security response time"]
}
],
alternativeApproaches: [
{
name: "Rodauth with JWT",
description: "Modern auth framework with JWT plugin",
advantages: ["Highly configurable", "Security-first design", "Active maintenance"],
disadvantages: ["Smaller community", "Steeper learning curve"],
complexity: "medium",
feasibility: 0.85,
timeToImplement: "1-2 weeks"
}
],
analysisDepth: "comprehensive",
confidenceLevel: 0.8,
analysisId: "auth-gem-analysis-2024"
});
`

$3

`typescript
// Recursive approach to building file explorer component
const response = await mcp.callTool("recursive_thinking", {
problem: "Build React file tree component supporting 10k+ nodes, lazy loading, search, and drag-drop. Current naive implementation freezes browser at 1k nodes.",
baseCases: [
{
condition: "Leaf node (file)",
solution: "Render simple FileItem component with icon and name",
complexity: "O(1)"
},
{
condition: "Empty folder",
solution: "Render FolderItem with empty state indicator",
complexity: "O(1)"
}
],
recursiveCases: [
{
condition: "Folder with children",
decomposition: "Render FolderItem, recursively render visible children only",
recombination: "Virtualize with react-window, render only viewport items",
reductionFactor: "Each level handles its immediate children only"
},
{
condition: "Search active",
decomposition: "Recursively search each subtree, maintain path to matches",
recombination: "Flatten matched paths, auto-expand parent folders",
reductionFactor: "Prune subtrees without matches"
}
],
terminationConditions: [
"Reached leaf node (file)",
"Folder is collapsed (skip children)",
"Node is outside viewport (virtualization)",
"Search term doesn't match subtree"
],
optimizations: [
{
technique: "virtualization",
description: "Render only visible nodes using react-window",
implementation: "FixedSizeTree with windowing based on expanded state",
complexityImprovement: "O(n) to O(k) where k is viewport size",
tradeoffs: ["Complex scroll position calculation", "Dynamic height handling"]
},
{
technique: "memoization",
description: "Cache rendered subtrees with React.memo",
implementation: "Memo based on node ID and expanded state",
complexityImprovement: "Avoid re-rendering unchanged subtrees"
}
],
complexityAnalysis: {
timeComplexity: "O(k) render time where k = visible nodes, O(n) for initial data structure",
spaceComplexity: "O(n) for tree structure, O(k) for rendered components",
maxStackDepth: "O(d) where d is tree depth"
},
domain: "React UI Components",
problemId: "file-tree-optimization-2024"
});
`

$3

`ruby

Modeling async job processing pipeline with failure handling

const response = await mcp.callTool("temporal_thinking", {
context: "Rails app processing user uploads through multiple stages: virus scan → image processing → CDN upload → notification. Current: 15% jobs stuck in limbo.",
initialState: "upload_received",
states: [
{
name: "upload_received",
description: "File uploaded to temporary storage",
properties: {
duration: { typical: "100ms", max: "1s" },
isStable: false,
priority: "high"
},
entryActions: ["Generate job ID", "Store file metadata", "Enqueue virus scan"],
invariants: ["File exists in tmp storage", "Job record created"]
},
{
name: "virus_scanning",
description: "ClamAV scanning file for malware",
properties: {
duration: { typical: "2s", max: "30s", timeout: "60s" },
isStable: false,
priority: "critical"
},
entryActions: ["Update job status", "Call ClamAV service"],
exitActions: ["Log scan results", "Clean up if infected"],
invariants: ["Scan process has file lock"]
},
{
name: "image_processing",
description: "Generate thumbnails and optimize images",
properties: {
duration: { typical: "5s", max: "60s" },
isStable: false,
priority: "medium"
},
entryActions: ["Load image into memory", "Apply transformations"],
exitActions: ["Save processed versions", "Update metadata"]
},
{
name: "cdn_uploading",
description: "Upload to S3 and invalidate CloudFront",
properties: {
duration: { typical: "3s", max: "30s" },
isStable: false,
priority: "medium",
retryable: true
},
entryActions: ["Generate S3 keys", "Start multipart upload"],
exitActions: ["Update URLs in database", "Delete temp files"]
},
{
name: "completed",
description: "Processing complete, user notified",
properties: {
isStable: true,
isFinal: true,
priority: "low"
},
entryActions: ["Send success notification", "Update file record", "Trigger webhooks"]
},
{
name: "failed",
description: "Processing failed, requires intervention",
properties: {
isStable: true,
isFinal: true,
priority: "high"
},
entryActions: ["Send failure notification", "Log error details", "Alert ops team if critical"]
}
],
events: [
{
name: "virus_scan_timeout",
description: "ClamAV didn't respond within 60 seconds",
properties: { type: "timeout", predictability: "stochastic" },
triggers: ["Sidekiq job timeout", "ClamAV service down"]
},
{
name: "s3_rate_limit",
description: "Hit S3 API rate limits",
properties: { type: "external", predictability: "stochastic" },
preconditions: ["High upload volume", "Retry storms"]
}
],
transitions: [
{
from: "upload_received",
to: "virus_scanning",
event: "scan_job_started",
properties: { probability: 0.98 },
action: "VirusScanJob.perform_async(file_id)"
},
{
from: "virus_scanning",
to: "failed",
event: "virus_detected",
properties: { probability: 0.002 },
action: "Delete infected file and notify user"
},
{
from: "virus_scanning",
to: "image_processing",
event: "scan_clean",
properties: { probability: 0.978 },
guard: "File is image type"
},
{
from: "cdn_uploading",
to: "cdn_uploading",
event: "s3_rate_limit",
properties: { probability: 0.05, maxRetries: 3 },
action: "Exponential backoff retry"
}
],
timeConstraints: [
{
description: "Total processing must complete within 5 minutes for UX",
type: "end-to-end",
value: "5 minutes"
},
{
description: "Virus scan timeout to prevent job pile-up",
type: "state-timeout",
value: "60 seconds",
state: "virus_scanning"
}
],
analysis: {
criticalPaths: [
{
path: ["upload_received", "virus_scanning", "image_processing", "cdn_uploading", "completed"],
probability: 0.83,
duration: "15 seconds typical, 2 minutes max"
}
],
bottlenecks: [
{
state: "virus_scanning",
reason: "ClamAV service timeouts causing 8% failure rate",
impact: "critical"
},
{
state: "cdn_uploading",
reason: "S3 rate limits during peak hours",
impact: "medium"
}
]
},
modelId: "upload-pipeline-2024",
domain: "Background Job Processing",
purpose: "Identify timeout issues and optimize job pipeline for 99% success rate"
});
``

Contributing

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

License

MIT License - see LICENSE for details.

Acknowledgments

- Based on the thinking-patterns server, which is based on the Model Context Protocol (MCP) by Anthropic
- Combines functionality from Clear Thought and Stochastic Thinking MCP servers
- Mental Models framework inspired by James Clear's comprehensive guide to mental models
- Stochastic algorithms based on classic works in reinforcement learning and decision theory