{
  "description": "MCP Configuration Options for task-engine-ai-core",
  "version": "0.3.1",
  "configurations": {
    "local_development": {
      "description": "Local development using project files",
      "recommended": true,
      "cursor": {
        "file": ".cursor/mcp.json",
        "config": {
          "mcpServers": {
            "task-engine-ai-core": {
              "command": "node",
              "args": [
                "C:\\Users\\visual-code\\Task-engine\\mcp-server\\server.js"
              ],
              "env": {
                "TASK_MASTER_PROJECT_ROOT": "C:\\Users\\visual-code\\Task-engine",
                "TASK_ENGINE_VERSION": "0.3.1",
                "TASK_ENGINE_ENVIRONMENT": "development",
                "TASK_ENGINE_DEBUG": "true",
                "TASK_ENGINE_LOG_LEVEL": "info"
              }
            }
          }
        }
      },
      "vscode": {
        "file": ".vscode/mcp.json",
        "config": {
          "servers": {
            "task-engine-ai-core": {
              "command": "node",
              "args": [
                "C:\\Users\\visual-code\\Task-engine\\mcp-server\\server.js"
              ],
              "env": {
                "TASK_MASTER_PROJECT_ROOT": "C:\\Users\\visual-code\\Task-engine",
                "TASK_ENGINE_VERSION": "0.3.1",
                "TASK_ENGINE_ENVIRONMENT": "development",
                "TASK_ENGINE_DEBUG": "true",
                "TASK_ENGINE_LOG_LEVEL": "info"
              }
            }
          }
        }
      }
    },
    "npm_package_global": {
      "description": "Using globally installed npm package",
      "requirements": ["npm install -g task-engine-ai-core"],
      "cursor": {
        "config": {
          "mcpServers": {
            "task-engine-ai-core": {
              "command": "task-master-mcp",
              "args": [],
              "env": {
                "TASK_MASTER_PROJECT_ROOT": "C:\\Users\\visual-code\\Task-engine",
                "TASK_ENGINE_VERSION": "0.3.1",
                "TASK_ENGINE_ENVIRONMENT": "development",
                "TASK_ENGINE_DEBUG": "true",
                "TASK_ENGINE_LOG_LEVEL": "info"
              }
            }
          }
        }
      },
      "vscode": {
        "config": {
          "servers": {
            "task-engine-ai-core": {
              "command": "task-master-mcp",
              "args": [],
              "env": {
                "TASK_MASTER_PROJECT_ROOT": "C:\\Users\\visual-code\\Task-engine",
                "TASK_ENGINE_VERSION": "0.3.1",
                "TASK_ENGINE_ENVIRONMENT": "development",
                "TASK_ENGINE_DEBUG": "true",
                "TASK_ENGINE_LOG_LEVEL": "info"
              }
            }
          }
        }
      }
    },
    "npm_package_npx": {
      "description": "Using npx with npm package (alternative approach)",
      "note": "This approach may have issues with MCP protocol",
      "cursor": {
        "config": {
          "mcpServers": {
            "task-engine-ai-core": {
              "command": "npx",
              "args": [
                "task-engine-ai-core",
                "mcp-server"
              ],
              "env": {
                "TASK_MASTER_PROJECT_ROOT": "C:\\Users\\visual-code\\Task-engine",
                "TASK_ENGINE_VERSION": "0.3.1",
                "TASK_ENGINE_ENVIRONMENT": "development",
                "TASK_ENGINE_DEBUG": "true",
                "TASK_ENGINE_LOG_LEVEL": "info"
              }
            }
          }
        }
      }
    },
    "node_modules_direct": {
      "description": "Using node_modules after local npm install",
      "requirements": ["npm install task-engine-ai-core"],
      "cursor": {
        "config": {
          "mcpServers": {
            "task-engine-ai-core": {
              "command": "node",
              "args": [
                "node_modules/task-engine-ai-core/mcp-server/server.js"
              ],
              "env": {
                "TASK_MASTER_PROJECT_ROOT": "C:\\Users\\visual-code\\Task-engine",
                "TASK_ENGINE_VERSION": "0.3.1",
                "TASK_ENGINE_ENVIRONMENT": "development",
                "TASK_ENGINE_DEBUG": "true",
                "TASK_ENGINE_LOG_LEVEL": "info"
              }
            }
          }
        }
      }
    }
  },
  "troubleshooting": {
    "common_issues": {
      "connection_closed": {
        "error": "MCP error -1: Connection closed",
        "causes": [
          "Incorrect command path",
          "Missing executable permissions",
          "Environment variable issues",
          "Node.js version compatibility"
        ],
        "solutions": [
          "Use local development configuration",
          "Verify Node.js version >= 18.0.0",
          "Check file paths are correct",
          "Ensure TASK_MASTER_PROJECT_ROOT is set correctly"
        ]
      },
      "package_not_found": {
        "error": "The following package was not found and will be installed",
        "causes": [
          "Package not installed globally",
          "Incorrect package name or version",
          "npm registry issues"
        ],
        "solutions": [
          "Install package globally: npm install -g task-engine-ai-core",
          "Use local development configuration",
          "Verify package exists: npm view task-engine-ai-core"
        ]
      },
      "terminated": {
        "error": "Terminated",
        "causes": [
          "Server startup failure",
          "Missing dependencies",
          "Configuration errors"
        ],
        "solutions": [
          "Check server logs for detailed error",
          "Verify all environment variables",
          "Use local development configuration"
        ]
      }
    },
    "debugging_steps": [
      "1. Test server manually: node mcp-server/server.js",
      "2. Check environment variables are set correctly",
      "3. Verify Node.js version: node --version",
      "4. Test package installation: npm list -g task-engine-ai-core",
      "5. Use local development configuration as fallback"
    ]
  },
  "recommended_setup": {
    "step1": "Use local development configuration for immediate testing",
    "step2": "Install package globally for production use",
    "step3": "Test both configurations to ensure compatibility",
    "step4": "Use environment variables for sensitive data"
  },
  "environment_variables": {
    "required": {
      "TASK_MASTER_PROJECT_ROOT": "Absolute path to project root directory"
    },
    "optional": {
      "TASK_ENGINE_VERSION": "Package version for compatibility",
      "TASK_ENGINE_ENVIRONMENT": "Environment configuration",
      "TASK_ENGINE_DEBUG": "Enable debug mode",
      "TASK_ENGINE_LOG_LEVEL": "Logging level",
      "ANTHROPIC_API_KEY": "Anthropic API key",
      "OPENAI_API_KEY": "OpenAI API key"
    }
  }
}