Wise Mise

The intelligent MCP server that transforms mise task management with AI-powered analysis and domain expertise

PyPI version Python 3.9+ License: MIT Code style: black Documentation Deploy to Smithery

Stop wrestling with mise configuration. Wise Mise MCP brings enterprise-grade intelligence to your mise workflow, automatically analyzing your project structure and creating perfectly organized, maintainable task architectures that scale with your development needs.

Why Wise Mise MCP?

🧠 Intelligent Task Analysis

• Automatically analyzes your project structure to extract meaningful tasks
• Understands 10+ technology domains (build, test, lint, deploy, CI/CD, etc.)
• Suggests optimal task organization and dependency patterns

🏗️ Architecture-Aware

• Follows mise best practices with hierarchical task organization
• Supports complex dependency graphs with source/output tracking
• Optimizes for incremental builds and performance

🔧 Developer Experience

• Integrates seamlessly with any MCP-compatible client
• Provides detailed explanations and recommendations
• Reduces cognitive load of task management

Quick Start

Using UVX (Recommended)

# Just run this to start Wise Mise MCP with UVX
uvx wise-mise-mcp

# Or install globally
uv tool install wise-mise-mcp

Traditional pip

pip install wise-mise-mcp

Add to Your MCP Client

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "wise-mise-mcp": {
      "command": "uvx",
      "args": ["wise_mise_mcp"]
    }
  }
}

Deploy with Smithery (One-Click Deployment)

Deploy to Smithery

Deploy Wise Mise MCP instantly to Smithery's cloud infrastructure with one click. Smithery provides managed MCP server hosting with built-in monitoring, scaling, and zero-configuration deployment.

Quick Smithery Deployment:

1. Click the "Deploy to Smithery" badge above
2. Connect your GitHub account (if needed)
3. Your MCP server will be automatically deployed and configured
4. Use the provided endpoint in your MCP client configuration

Benefits of Smithery Deployment:

• ✅ Zero server management overhead
• ✅ Automatic scaling and load balancing
• ✅ Built-in monitoring and health checks
• ✅ Global CDN for low-latency access
• ✅ Automatic SSL/TLS encryption
• ✅ Integration with popular MCP clients

What Makes It "Wise"?

Wise Mise MCP goes beyond simple task creation. It brings intelligence to your mise configuration:

🔍 Project Analysis

# Analyzes your entire project structure
analyze_project_for_tasks("/path/to/project")
# Returns strategically organized tasks based on your tech stack

🕸️ Dependency Mapping

# Traces complex task relationships
trace_task_chain("/path/to/project", "build:prod")
# Visualizes the complete execution flow

⚡ Smart Task Creation

# Intelligently places tasks in the right domain
create_task(
    project_path="/path/to/project",
    task_description="Run TypeScript type checking",
    # Automatically suggests: lint:types with proper dependencies
)

Core Features

🎯 Domain Experts

• Build: Frontend/Backend build systems, bundlers, compilers
• Test: Unit, integration, e2e testing strategies
• Lint: Code quality, formatting, static analysis
• Deploy: CI/CD, containerization, release management
• Database: Migrations, seeding, schema management
• Development: Local dev servers, hot reloading, debugging

📊 Intelligent Analysis

• Complexity Assessment: Automatically categorizes tasks as Simple, Moderate, or Complex
• Dependency Detection: Identifies natural task relationships
• Source/Output Tracking: Optimizes incremental builds
• Redundancy Elimination: Finds and removes duplicate tasks

🔧 MCP Tools

Tool	Purpose
analyze_project_for_tasks	Extract strategic tasks from project structure
trace_task_chain	Map task dependencies and execution flow
create_task	Add new tasks with intelligent placement
prune_tasks	Remove outdated or redundant tasks
validate_task_architecture	Ensure configuration follows best practices
get_task_recommendations	Get suggestions for optimization

Example Workflows

Analyzing a New Project

# Let Wise Mise MCP analyze your project
> analyze_project_for_tasks("./my-app")

✅ Detected: Next.js + TypeScript + Prisma
📋 Suggested Tasks:
  ├── build:dev (next dev)
  ├── build:prod (next build)
  ├── test:unit (jest)
  ├── test:e2e (playwright)
  ├── lint:code (eslint)
  ├── lint:types (tsc --noEmit)
  ├── db:migrate (prisma migrate)
  └── deploy:vercel (vercel deploy)

Understanding Task Dependencies

# Trace the execution flow
> trace_task_chain("./my-app", "deploy:prod")

🕸️ Task Chain for deploy:prod:
  1. lint:types (TypeScript check)
  2. test:unit (Unit tests)
  3. build:prod (Production build)
  4. deploy:prod (Deploy to production)

💡 Recommendation: Add test:e2e before deploy:prod

Smart Task Creation

# Describe what you want, get intelligent suggestions
> create_task(
    project_path="./my-app",
    task_description="Generate API documentation from OpenAPI spec"
  )

🧠 Analysis: Documentation generation task
📍 Suggested Placement: docs:api
🔗 Dependencies: build:prod (for spec generation)
📝 Suggested Implementation:
  [tasks.docs.api]
  run = "swagger-codegen generate -i ./openapi.json -l html2 -o ./docs/api"
  sources = ["src/api/**/*.ts", "openapi.json"]
  outputs = ["docs/api/**/*"]

Architecture Philosophy

Wise Mise MCP follows a Domain-Driven Design approach to task organization:

🏛️ Hierarchical Structure

• Level 1: Domain (build, test, lint, etc.)
• Level 2: Environment/Type (dev, prod, unit, e2e)
• Level 3: Specific Implementation (server, client, api)

🔄 Dependency Patterns

• Sequential: lint → test → build → deploy
• Parallel: test:unit + test:e2e → deploy
• Conditional: deploy:staging → test:smoke → deploy:prod

⚡ Performance Optimization

• Source Tracking: Only rebuild when sources change
• Output Caching: Reuse previous build artifacts
• Incremental Builds: Support for modern build tools

Technology Support

Wise Mise MCP includes expert knowledge for:

Frontend: React, Vue, Angular, Svelte, Next.js, Nuxt, Vite, Webpack Backend: Node.js, Python, Go, Rust, Java, .NET, PHP Databases: PostgreSQL, MySQL, MongoDB, Redis, Prisma, TypeORM Testing: Jest, Vitest, Cypress, Playwright, PyTest, Go Test CI/CD: GitHub Actions, GitLab CI, CircleCI, Jenkins Deployment: Docker, Kubernetes, Vercel, Netlify, AWS, GCP

Contributing

We welcome contributions! See our Contributing Guide for details.

Quick Start for Contributors

# Clone and setup with UV
git clone https://github.com/delorenj/wise-mise-mcp
cd wise-mise-mcp
uv sync

# Run tests
uv run pytest

# Format code
uv run black .
uv run ruff check --fix .

License

MIT License - see LICENSE for details.

Support

• Documentation: Full API Documentation
• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Built with ❤️ by Jarad DeLorenzo and the open source community