{"id":29130686,"url":"https://github.com/charris-msft/chat-mode-creator-mcp","last_synced_at":"2025-10-29T13:39:31.857Z","repository":{"id":298536958,"uuid":"1000319595","full_name":"charris-msft/chat-mode-creator-mcp","owner":"charris-msft","description":"MCP server for creating custom VS Code chat modes for specialized development workflows","archived":false,"fork":false,"pushed_at":"2025-06-11T15:49:27.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-30T04:40:42.591Z","etag":null,"topics":["azure","bicep","chatmode","lambda","mcp","model-context-protocol","spec-driven-development","vscode"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/charris-msft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-11T15:39:18.000Z","updated_at":"2025-06-11T15:49:31.000Z","dependencies_parsed_at":"2025-06-11T17:09:51.493Z","dependency_job_id":"ace60c27-3175-409e-8ee3-7ab2c5f816b9","html_url":"https://github.com/charris-msft/chat-mode-creator-mcp","commit_stats":null,"previous_names":["charris-msft/chat-mode-creator-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/charris-msft/chat-mode-creator-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charris-msft%2Fchat-mode-creator-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charris-msft%2Fchat-mode-creator-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charris-msft%2Fchat-mode-creator-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charris-msft%2Fchat-mode-creator-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/charris-msft","download_url":"https://codeload.github.com/charris-msft/chat-mode-creator-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charris-msft%2Fchat-mode-creator-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278811847,"owners_count":26050181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure","bicep","chatmode","lambda","mcp","model-context-protocol","spec-driven-development","vscode"],"created_at":"2025-06-30T04:32:19.757Z","updated_at":"2025-10-07T16:56:13.105Z","avatar_url":"https://github.com/charris-msft.png","language":"Python","readme":"# 🎯 Chat Mode Creator MCP Server\n\nAn advanced MCP (Model Context Protocol) server that creates custom VS Code chat modes AND custom prompts for specialized development workflows.\n\n## ✨ Key Features\n\n🎯 **Integrated Workflow**: Chat modes come with related custom prompts  \n📁 **VS Code Compatible**: Follows official VS Code chat mode and prompt specifications  \n🚀 **Ready-to-Use**: Pre-built templates for common development scenarios  \n⚡ **Intelligent Matching**: Analyzes queries to suggest appropriate modes  \n\n## 🛠️ Available Chat Modes \u0026 Custom Prompts\n\n### 🔄 **Lambda to Azure Functions Migration**\n**Chat Mode**: Comprehensive migration guidance from AWS Lambda to Azure Functions\n- Runtime and service mapping assistance\n- Code conversion patterns and best practices  \n- Infrastructure migration support\n\n**Custom Prompts**:\n- `/evaluate` - Assess migration readiness and complexity\n- `/validate` - Verify migrated functions work correctly\n\n### 🏗️ **Azure Bicep Development**\n**Chat Mode**: Expert assistance for Azure Bicep infrastructure as code\n- Azure Well-Architected Framework integration\n- Advanced Bicep patterns and techniques\n- Security, monitoring, and deployment best practices\n\n**Custom Prompts**:\n- `/review` - Code review and best practices validation\n- `/deploy` - Safe deployment procedures and checks\n\n### 📋 **Spec-Driven Development**\n**Chat Mode**: Transform specifications into code through systematic process\n- Treats specifications as the primary development artifact\n- Follows systematic 5-phase SDD workflow\n- Includes consistency validation and checklist integration\n\n**Custom Prompts**:\n- `/validate_spec` - Validate specifications for completeness\n- `/generate_tests` - Generate comprehensive test suites\n\n## 🚀 Quick Installation\n\n### 1. **Install Dependencies**\n```bash\n# Create and activate virtual environment (.venv)\npython -m venv .venv\n.\\.venv\\Scripts\\Activate.ps1  # Windows PowerShell\n# .venv/bin/activate          # Linux/Mac\n\n# Install required packages\npip install -r requirements.txt\n```\n\n### 2. **Test Server**\n```bash\n# Test that the server runs correctly\npython mcp_chatmode_server.py\n```\n\n### 3. **Configure VS Code**\nAdd to your VS Code User Settings (`settings.json`):\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"chat-mode-creator\": {\n        \"command\": \"C:\\\\path\\\\to\\\\your\\\\.venv\\\\Scripts\\\\python.exe\",\n        \"args\": [\"C:\\\\path\\\\to\\\\your\\\\mcp_chatmode_server.py\"],\n        \"cwd\": \"C:\\\\path\\\\to\\\\your\\\\workspace\",\n        \"env\": {\n          \"PYTHONPATH\": \"C:\\\\path\\\\to\\\\your\\\\workspace\",\n          \"VIRTUAL_ENV\": \"C:\\\\path\\\\to\\\\your\\\\.venv\"\n        }\n      }\n    }\n  },\n  \"chat.mcp.discovery.enabled\": true,\n  \"chat.promptFiles\": true\n}\n```\n\n## 🛠️ Available Tools\n\n### **`create_chat_mode`** ⭐ Main Tool\nCreates chat modes with integrated custom prompts\n- **Parameters:**\n  - `mode_type` (required): `\"spec_driven_development\"`, `\"lambda_to_functions_migration\"`, or `\"azure_bicep_development\"`\n  - `workspace_path` (optional): Workspace path (defaults to current directory)\n\n### **`suggest_chat_mode`** 🎯 Smart Assistant  \nAnalyzes your query and suggests the most appropriate chat mode\n- **Parameters:**\n  - `user_query` (required): Description of what you want to accomplish\n  - `workspace_path` (optional): Workspace path (defaults to current directory)\n\n### **`create_custom_prompt`** 🎨 Advanced\nCreate individual custom prompts for specific tasks\n- **Parameters:**\n  - `mode_type` (required): The chat mode this prompt belongs to\n  - `prompt_name` (required): Name for the custom prompt\n  - `custom_description` (optional): Custom description for the prompt\n\n### **`list_mode_prompts`** 📋 Reference\nList all available custom prompts for a specific chat mode\n- **Parameters:**\n  - `mode_type` (required): The chat mode to list prompts for\n\n## 📁 File Structure\n\nFiles are created following VS Code standards:\n\n```\n.github/\n├── chatmodes/\n│   ├── azure-bicep-development.chatmode.md\n│   ├── lambda-to-functions-migration.chatmode.md\n│   └── spec-driven-development.chatmode.md\n└── prompts/\n    ├── review.prompt.md      # Azure Bicep prompts\n    ├── deploy.prompt.md\n    ├── evaluate.prompt.md    # Lambda migration prompts  \n    ├── validate.prompt.md\n    ├── validate_spec.prompt.md   # Spec-driven prompts\n    └── generate_tests.prompt.md\n```\n\n## 💡 Usage Examples\n\n### Natural Language Interaction\nJust ask Copilot naturally:\n- *\"I want to migrate my AWS Lambda to Azure Functions\"*\n- *\"Help me with Azure Bicep infrastructure templates\"*  \n- *\"I need assistance with specification-driven development\"*\n\nCopilot will automatically use the MCP tools to suggest and create appropriate chat modes.\n\n### Direct Tool Usage\n```python\n# Create Azure Bicep mode with prompts\ncreate_chat_mode(\n    mode_type=\"azure_bicep_development\",\n    workspace_path=\"/path/to/your/project\"\n)\n\n# Get intelligent suggestions\nsuggest_chat_mode(\n    user_query=\"I need help migrating serverless functions\",\n    workspace_path=\"/path/to/your/project\"\n)\n\n# Create a custom prompt\ncreate_custom_prompt(\n    mode_type=\"azure_bicep_development\",\n    prompt_name=\"security_scan\",\n    custom_description=\"Scan templates for security issues\"\n)\n```\n\n## 🎯 Using in VS Code\n\n### 1. **Chat Modes**\n- Open VS Code Chat view\n- Select your custom mode from the dropdown\n- Get specialized assistance for that workflow\n\n### 2. **Custom Prompts**  \n- In chat, type `/prompt_name` (e.g., `/review`, `/evaluate`)\n- Prompts automatically include mode-specific context\n- Combine with file references for targeted help\n\n### 3. **Integration Example**\n```\nChat Mode: Azure Bicep Development\nPrompt: /review\nContext: main.bicep file\nResult: Comprehensive security and best practices review\n```\n\n## 🔧 Troubleshooting\n\n### MCP Server Won't Connect in VS Code\n1. **Check VS Code MCP settings**:\n   - Ensure `\"chat.mcp.discovery.enabled\": true` is set\n   - Verify the server paths are correct with capital drive letters\n   - Check that the virtual environment path exists\n\n2. **Restart VS Code** after making settings changes\n\n3. **Check the MCP server logs** in VS Code:\n   - Open Command Palette (`Ctrl+Shift+P`)\n   - Run \"Developer: Show Logs\"\n   - Look for MCP server connection errors\n\n### Server Won't Start\n1. **Ensure virtual environment is activated**:\n   ```powershell\n   .\\.venv\\Scripts\\Activate.ps1  # Windows\n   source .venv/bin/activate     # Linux/Mac\n   ```\n\n2. **Check dependencies**:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. **Test manually**:\n   ```bash\n   python mcp_chatmode_server.py\n   ```\n\n### Copilot Not Using MCP Tools\n1. **Make sure MCP discovery is enabled**: `\"chat.mcp.discovery.enabled\": true`\n2. **Try explicit requests**: \"Use the suggest_chat_mode tool to help me...\"\n3. **Check server status**: Look for \"chat-mode-creator\" in the MCP server list\n4. **Restart VS Code** if the server was recently added\n\n### Environment Variables Issues\nIf you see import errors, ensure these environment variables are set in your MCP configuration:\n```json\n\"env\": {\n  \"PYTHONPATH\": \"/path/to/your/workspace\",\n  \"VIRTUAL_ENV\": \"/path/to/your/.venv\"\n}\n```\n\n## 🎨 Advanced Configuration\n\n### Alternative Launcher Scripts\nYou can also use PowerShell scripts for easier management:\n\n**run-mcp-server.ps1**:\n```powershell\ncd \"C:\\path\\to\\your\\workspace\"\n.\\.venv\\Scripts\\Activate.ps1\npython mcp_chatmode_server.py\n```\n\n**VS Code Configuration with PowerShell**:\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"chat-mode-creator\": {\n        \"command\": \"powershell\",\n        \"args\": [\n          \"-ExecutionPolicy\", \"Bypass\",\n          \"-File\", \"C:\\\\path\\\\to\\\\run-mcp-server.ps1\"\n        ]\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop Integration\nFor Claude Desktop users, add to your configuration:\n```json\n{\n  \"mcpServers\": {\n    \"chat-mode-creator\": {\n      \"command\": \"/path/to/your/.venv/bin/python\",\n      \"args\": [\"/path/to/your/mcp_chatmode_server.py\"],\n      \"cwd\": \"/path/to/your/workspace\"\n    }\n  }\n}\n```\n\n## 🎯 Custom Prompt Examples\n\n### Lambda Migration Evaluation (`/evaluate`)\nAnalyzes AWS Lambda functions for migration readiness:\n- Runtime compatibility assessment\n- Infrastructure dependency mapping  \n- Performance characteristic evaluation\n- Migration complexity scoring\n\n### Bicep Template Review (`/review`)\nComprehensive Bicep template analysis:\n- Security best practices validation\n- Azure Well-Architected Framework compliance\n- Cost optimization recommendations\n- Code quality assessment\n\n### Specification Validation (`/validate_spec`)\nEnsures specifications are ready for code generation:\n- Completeness checking\n- Consistency analysis\n- Implementation readiness validation\n- Gap identification and resolution\n\n## 🤝 Contributing\n\nExtend this MCP server with additional chat modes:\n\n1. **Add new templates** to `chat_modes/` directory\n2. **Create new prompt files** for the mode\n3. **Update** `AVAILABLE_PROMPT_TEMPLATES` in server code\n4. **Test** with the provided test scripts\n5. **Submit PR** with examples and documentation\n\n### Template Structure\n```markdown\n---\ndescription: Brief description of the chat mode\ntools: ['relevant', 'tools', 'list']\n---\n\n# Chat Mode Name\n\n## Purpose\nWhat this mode helps with...\n\n## Usage Guidelines  \nHow to use this mode effectively...\n\n## Related Prompts\n- `/prompt1` - Description\n- `/prompt2` - Description\n```\n\n## 📊 Project Structure\n```\nchat-mode-creator/\n├── mcp_chatmode_server.py          # Main MCP server\n├── chat_modes/                     # Source templates\n│   ├── azure-bicep-development.chatmode.md\n│   ├── lambda-to-functions-migration.chatmode.md\n│   ├── spec-driven-development.chatmode.md\n│   └── */                          # Mode-specific prompts\n├── requirements.txt                # Python dependencies\n├── example_usage.py                # Usage examples\n├── test_server.py                  # Test scripts\n└── .venv/                          # Virtual environment\n```\n\n## 📄 License\n\nMIT License - See LICENSE file for details\n\n---\n\n🎉 **Ready to supercharge your VS Code chat experience with specialized modes and custom prompts!**\n\n*This MCP server intelligently creates organized chat modes and prompts that follow VS Code's official specifications, making your development workflow more efficient and context-aware.*\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharris-msft%2Fchat-mode-creator-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcharris-msft%2Fchat-mode-creator-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharris-msft%2Fchat-mode-creator-mcp/lists"}