# 🎯 Wise Mise MCP
> **The intelligent MCP server that transforms mise task management with AI-powered analysis and domain expertise**
[](https://badge.fury.io/py/wise-mise-mcp)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/psf/black)
[](https://wise-mise-mcp.readthedocs.io)
**Stop wrestling with mise configuration.** Wise Mise MCP brings enterprise-grade intelligence to your [mise](https://mise.jdx.dev/) 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)
```bash
# 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
```bash
pip install wise-mise-mcp
```
### Add to Your MCP Client
Add to your MCP client configuration (e.g., Claude Desktop):
```json
{
"mcpServers": {
"wise-mise-mcp": {
"command": "uvx",
"args": ["wise_mise_mcp"]
}
}
}
```
## What Makes It "Wise"?
Wise Mise MCP goes beyond simple task creation. It brings intelligence to your mise configuration:
### 🔍 Project Analysis
```python
# Analyzes your entire project structure
analyze_project_for_tasks("/path/to/project")
# Returns strategically organized tasks based on your tech stack
```
### 🕸️ Dependency Mapping
```python
# Traces complex task relationships
trace_task_chain("/path/to/project", "build:prod")
# Visualizes the complete execution flow
```
### ⚡ Smart Task Creation
```python
# 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
```bash
# 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
```bash
# 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
```bash
# 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](CONTRIBUTING.md) for details.
### Quick Start for Contributors
```bash
# 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](LICENSE) for details.
## Support
- **Documentation**: [Full API Documentation](https://wise-mise-mcp.readthedocs.io/)
- **Issues**: [GitHub Issues](https://github.com/delorenj/wise-mise-mcp/issues)
- **Discussions**: [GitHub Discussions](https://github.com/delorenj/wise-mise-mcp/discussions)
---
_Built with ❤️ by [Jarad DeLorenzo](https://github.com/delorenj) and the open source community_
Raw data
{
"_id": null,
"home_page": null,
"name": "wise-mise-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai-assistant, automation, build-tools, development, intelligent, mcp, mise, mise-en-place, task-management, workflow",
"author": null,
"author_email": "Jarad DeLorenzo <jaradd@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/93/5d/b4873c451cc5ebe2ba54bfcfbe2b33052e31da5701da55e9d2fc14775b5e/wise_mise_mcp-0.1.1.tar.gz",
"platform": null,
"description": "# \ud83c\udfaf Wise Mise MCP\n\n> **The intelligent MCP server that transforms mise task management with AI-powered analysis and domain expertise**\n\n[](https://badge.fury.io/py/wise-mise-mcp)\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/psf/black)\n[](https://wise-mise-mcp.readthedocs.io)\n\n**Stop wrestling with mise configuration.** Wise Mise MCP brings enterprise-grade intelligence to your [mise](https://mise.jdx.dev/) workflow, automatically analyzing your project structure and creating perfectly organized, maintainable task architectures that scale with your development needs.\n\n## Why Wise Mise MCP?\n\n**\ud83e\udde0 Intelligent Task Analysis**\n\n- Automatically analyzes your project structure to extract meaningful tasks\n- Understands 10+ technology domains (build, test, lint, deploy, CI/CD, etc.)\n- Suggests optimal task organization and dependency patterns\n\n**\ud83c\udfd7\ufe0f Architecture-Aware**\n\n- Follows mise best practices with hierarchical task organization\n- Supports complex dependency graphs with source/output tracking\n- Optimizes for incremental builds and performance\n\n**\ud83d\udd27 Developer Experience**\n\n- Integrates seamlessly with any MCP-compatible client\n- Provides detailed explanations and recommendations\n- Reduces cognitive load of task management\n\n## Quick Start\n\n### Using UVX (Recommended)\n\n```bash\n# Just run this to start Wise Mise MCP with UVX\nuvx wise-mise-mcp\n\n# Or install globally\nuv tool install wise-mise-mcp\n```\n\n### Traditional pip\n\n```bash\npip install wise-mise-mcp\n```\n\n### Add to Your MCP Client\n\nAdd to your MCP client configuration (e.g., Claude Desktop):\n\n```json\n{\n \"mcpServers\": {\n \"wise-mise-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"wise_mise_mcp\"]\n }\n }\n}\n```\n\n## What Makes It \"Wise\"?\n\nWise Mise MCP goes beyond simple task creation. It brings intelligence to your mise configuration:\n\n### \ud83d\udd0d Project Analysis\n\n```python\n# Analyzes your entire project structure\nanalyze_project_for_tasks(\"/path/to/project\")\n# Returns strategically organized tasks based on your tech stack\n```\n\n### \ud83d\udd78\ufe0f Dependency Mapping\n\n```python\n# Traces complex task relationships\ntrace_task_chain(\"/path/to/project\", \"build:prod\")\n# Visualizes the complete execution flow\n```\n\n### \u26a1 Smart Task Creation\n\n```python\n# Intelligently places tasks in the right domain\ncreate_task(\n project_path=\"/path/to/project\",\n task_description=\"Run TypeScript type checking\",\n # Automatically suggests: lint:types with proper dependencies\n)\n```\n\n## Core Features\n\n### \ud83c\udfaf **Domain Experts**\n\n- **Build**: Frontend/Backend build systems, bundlers, compilers\n- **Test**: Unit, integration, e2e testing strategies\n- **Lint**: Code quality, formatting, static analysis\n- **Deploy**: CI/CD, containerization, release management\n- **Database**: Migrations, seeding, schema management\n- **Development**: Local dev servers, hot reloading, debugging\n\n### \ud83d\udcca **Intelligent Analysis**\n\n- **Complexity Assessment**: Automatically categorizes tasks as Simple, Moderate, or Complex\n- **Dependency Detection**: Identifies natural task relationships\n- **Source/Output Tracking**: Optimizes incremental builds\n- **Redundancy Elimination**: Finds and removes duplicate tasks\n\n### \ud83d\udd27 **MCP Tools**\n\n| Tool | Purpose |\n| ---------------------------- | ---------------------------------------------- |\n| `analyze_project_for_tasks` | Extract strategic tasks from project structure |\n| `trace_task_chain` | Map task dependencies and execution flow |\n| `create_task` | Add new tasks with intelligent placement |\n| `prune_tasks` | Remove outdated or redundant tasks |\n| `validate_task_architecture` | Ensure configuration follows best practices |\n| `get_task_recommendations` | Get suggestions for optimization |\n\n## Example Workflows\n\n### Analyzing a New Project\n\n```bash\n# Let Wise Mise MCP analyze your project\n> analyze_project_for_tasks(\"./my-app\")\n\n\u2705 Detected: Next.js + TypeScript + Prisma\n\ud83d\udccb Suggested Tasks:\n \u251c\u2500\u2500 build:dev (next dev)\n \u251c\u2500\u2500 build:prod (next build)\n \u251c\u2500\u2500 test:unit (jest)\n \u251c\u2500\u2500 test:e2e (playwright)\n \u251c\u2500\u2500 lint:code (eslint)\n \u251c\u2500\u2500 lint:types (tsc --noEmit)\n \u251c\u2500\u2500 db:migrate (prisma migrate)\n \u2514\u2500\u2500 deploy:vercel (vercel deploy)\n```\n\n### Understanding Task Dependencies\n\n```bash\n# Trace the execution flow\n> trace_task_chain(\"./my-app\", \"deploy:prod\")\n\n\ud83d\udd78\ufe0f Task Chain for deploy:prod:\n 1. lint:types (TypeScript check)\n 2. test:unit (Unit tests)\n 3. build:prod (Production build)\n 4. deploy:prod (Deploy to production)\n\n\ud83d\udca1 Recommendation: Add test:e2e before deploy:prod\n```\n\n### Smart Task Creation\n\n```bash\n# Describe what you want, get intelligent suggestions\n> create_task(\n project_path=\"./my-app\",\n task_description=\"Generate API documentation from OpenAPI spec\"\n )\n\n\ud83e\udde0 Analysis: Documentation generation task\n\ud83d\udccd Suggested Placement: docs:api\n\ud83d\udd17 Dependencies: build:prod (for spec generation)\n\ud83d\udcdd Suggested Implementation:\n [tasks.docs.api]\n run = \"swagger-codegen generate -i ./openapi.json -l html2 -o ./docs/api\"\n sources = [\"src/api/**/*.ts\", \"openapi.json\"]\n outputs = [\"docs/api/**/*\"]\n```\n\n## Architecture Philosophy\n\nWise Mise MCP follows a **Domain-Driven Design** approach to task organization:\n\n### \ud83c\udfdb\ufe0f **Hierarchical Structure**\n\n- **Level 1**: Domain (build, test, lint, etc.)\n- **Level 2**: Environment/Type (dev, prod, unit, e2e)\n- **Level 3**: Specific Implementation (server, client, api)\n\n### \ud83d\udd04 **Dependency Patterns**\n\n- **Sequential**: `lint \u2192 test \u2192 build \u2192 deploy`\n- **Parallel**: `test:unit` + `test:e2e` \u2192 `deploy`\n- **Conditional**: `deploy:staging` \u2192 `test:smoke` \u2192 `deploy:prod`\n\n### \u26a1 **Performance Optimization**\n\n- **Source Tracking**: Only rebuild when sources change\n- **Output Caching**: Reuse previous build artifacts\n- **Incremental Builds**: Support for modern build tools\n\n## Technology Support\n\nWise Mise MCP includes expert knowledge for:\n\n**Frontend**: React, Vue, Angular, Svelte, Next.js, Nuxt, Vite, Webpack\n**Backend**: Node.js, Python, Go, Rust, Java, .NET, PHP\n**Databases**: PostgreSQL, MySQL, MongoDB, Redis, Prisma, TypeORM\n**Testing**: Jest, Vitest, Cypress, Playwright, PyTest, Go Test\n**CI/CD**: GitHub Actions, GitLab CI, CircleCI, Jenkins\n**Deployment**: Docker, Kubernetes, Vercel, Netlify, AWS, GCP\n\n## Contributing\n\nWe welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Quick Start for Contributors\n\n```bash\n# Clone and setup with UV\ngit clone https://github.com/delorenj/wise-mise-mcp\ncd wise-mise-mcp\nuv sync\n\n# Run tests\nuv run pytest\n\n# Format code\nuv run black .\nuv run ruff check --fix .\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Support\n\n- **Documentation**: [Full API Documentation](https://wise-mise-mcp.readthedocs.io/)\n- **Issues**: [GitHub Issues](https://github.com/delorenj/wise-mise-mcp/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/delorenj/wise-mise-mcp/discussions)\n\n---\n\n_Built with \u2764\ufe0f by [Jarad DeLorenzo](https://github.com/delorenj) and the open source community_\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An intelligent MCP server for wise mise task management and organization",
"version": "0.1.1",
"project_urls": {
"Changelog": "https://github.com/delorenj/wise-mise-mcp/blob/main/docs/CHANGELOG.md",
"Discussions": "https://github.com/delorenj/wise-mise-mcp/discussions",
"Documentation": "https://github.com/delorenj/wise-mise-mcp#readme",
"Homepage": "https://github.com/delorenj/wise-mise-mcp",
"Issues": "https://github.com/delorenj/wise-mise-mcp/issues",
"Repository": "https://github.com/delorenj/wise-mise-mcp.git"
},
"split_keywords": [
"ai-assistant",
" automation",
" build-tools",
" development",
" intelligent",
" mcp",
" mise",
" mise-en-place",
" task-management",
" workflow"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "73e98cf7eeed0b4570205c31be9df053228a239738a8b3a75c37f6fe94f1999a",
"md5": "22e651c190fe0736af2ff6a9197f009a",
"sha256": "482c8f780533f987f6d3ade9bf63b69f831e3bc51238238a60c88f6d2b130c40"
},
"downloads": -1,
"filename": "wise_mise_mcp-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "22e651c190fe0736af2ff6a9197f009a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 22307,
"upload_time": "2025-08-20T19:20:30",
"upload_time_iso_8601": "2025-08-20T19:20:30.354597Z",
"url": "https://files.pythonhosted.org/packages/73/e9/8cf7eeed0b4570205c31be9df053228a239738a8b3a75c37f6fe94f1999a/wise_mise_mcp-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "935db4873c451cc5ebe2ba54bfcfbe2b33052e31da5701da55e9d2fc14775b5e",
"md5": "d91e61e4fd6015368f571b072fdc7a8f",
"sha256": "e423ee1833a6a4bb733a11757cb7103f29ba12f437ea506e31b15bc22baae10a"
},
"downloads": -1,
"filename": "wise_mise_mcp-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "d91e61e4fd6015368f571b072fdc7a8f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 67553,
"upload_time": "2025-08-20T19:20:31",
"upload_time_iso_8601": "2025-08-20T19:20:31.568764Z",
"url": "https://files.pythonhosted.org/packages/93/5d/b4873c451cc5ebe2ba54bfcfbe2b33052e31da5701da55e9d2fc14775b5e/wise_mise_mcp-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-20 19:20:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "delorenj",
"github_project": "wise-mise-mcp",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "wise-mise-mcp"
}
JSON
