workspace-init-mcp

workspace-init-mcp

MCP server that initializes workspaces with AI agent instructions, Agent Skills, documentation governance, and project structure — across VS Code, Cursor, Claude Code, and OpenHands.

Just say "initialize workspace" to your LLM — it generates everything automatically based on your project type.

#Learning #WebApp #API #Mobile #DataScience #DevOps #Creative #Library #Monorepo #Consulting #Ecommerce #Fintech #Healthcare #SaaS #IoT

Setup

Add to your MCP config and you're done.

VS Code (settings.json)

{
  "mcp": {
    "servers": {
      "workspace-init": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "workspace-init-mcp"]
      }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "workspace-init": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "workspace-init-mcp"]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "workspace-init": {
      "command": "npx",
      "args": ["-y", "workspace-init-mcp"]
    }
  }
}

What It Does

Tell your LLM "initialize workspace" and it generates:

• .github/copilot-instructions.md — Global AI agent instructions
• .github/agents/ & .github/skills/ — Agent Skills (50+ agents, 40+ skills)
• .vscode/settings.json & *.instructions.md — Custom instructions (code, test, review, commit, PR)
• .editorconfig & .gitattributes — Cross-editor consistency
• docs/ — Documentation governance (work-logs, changelog, ADR, troubleshooting)

Tools

Tool	Description
initialize_workspace	Generate all workspace files
preview_workspace_init	Preview without creating files
analyze_workspace	Detect project type & tech stack
validate_workspace	Check initialization completeness
list_project_types	List available project types
get_init_form_schema	Get input form schema
recommend_agent_skills	Get skill recommendations
search_agent_skills	Search skill catalog
install_agent_skills	Install specific skills/agents
list_agent_skills_catalog	Browse full catalog

Project Types

Type	Label	Best For
learning	학습/자기개발	Tutorials, study projects, self-learning
web-app	웹 애플리케이션	Frontend / fullstack web apps
api	API 서버	Backend REST / GraphQL services
mobile	모바일 앱	iOS, Android, cross-platform apps
data-science	데이터 사이언스	ML/AI, data analysis, Jupyter notebooks
devops	DevOps/인프라	CI/CD, IaC, cloud infrastructure
creative	크리에이티브/콘텐츠	Writing, content creation, documentation
library	라이브러리/패키지	Reusable libraries, npm/pip packages
monorepo	모노레포	Multi-package repositories
consulting	컨설팅/SI	IT consulting, proposals, deliverables
ecommerce	이커머스/커머스	Online shopping, payments, order management
fintech	핀테크/금융	Banking, payments, regulatory compliance
healthcare	헬스케어/의료	EMR, health services, HIPAA compliance
saas	SaaS 플랫폼	Multi-tenant platforms, subscription billing
iot	IoT/임베디드	IoT devices, sensors, edge computing
other	기타	Custom / general-purpose projects

License

MIT