Vibe Coding Documentation MCP (MUSE)

# Vibe Coding Documentation MCP (MUSE) MCP server that automatically collects, summarizes, documents, and publishes code and design decisions created during vibe coding sessions. ## Features This MCP server provides 10 tools for managing vibe coding documentation: | Tool | Description | |------|-------------| | `muse_collect_code_context` | Collects code blocks and conversation summaries into structured context | | `muse_summarize_design_decisions` | Extracts key architectural and design decisions from conversation logs | | `muse_generate_dev_document` | Generates README, DESIGN, TUTORIAL, CHANGELOG, API, or ARCHITECTURE documents | | `muse_normalize_for_platform` | Converts Markdown documents for Notion, GitHub Wiki, or Obsidian | | `muse_publish_document` | Publishes generated documents to external platforms | | `muse_create_session_log` | Creates daily or session-based vibe coding session logs | | `muse_analyze_code` | AST-based code analysis with Mermaid diagram generation | | `muse_session_history` | Manages session history - save, retrieve, search past sessions | | `muse_export_session` | Exports sessions to Markdown, JSON, or HTML formats | | `muse_project_profile` | Manages project-specific settings and configurations | ### Additional Features (v2.0) - **AST Parsing**: TypeScript, Python, Go code analysis - **Mermaid Diagrams**: Class, Flowchart, Sequence, ER, Architecture diagrams - **Multi-language**: Korean/English support - **6 Document Types**: README, DESIGN, TUTORIAL, CHANGELOG, API, ARCHITECTURE - **6 Platforms**: Notion, GitHub Wiki, Obsidian, Confluence, Slack, Discord ### Code Quality (v2.1) - **Input Validation**: Zod schema-based type-safe validation for all tools - **Error Handling**: Structured error classes (ToolError, ValidationError, PlatformError) - **Security**: Command injection prevention (exec → spawn), path sanitization - **Performance**: LRU cache, regex cache, memoization utilities ### Security (v2.2) - **Path Traversal Prevention**: Validates file paths stay within allowed directories - **SSRF Protection**: Webhook URL validation for Slack/Discord - **Network Timeout**: AbortController-based request timeout (30s default) - **Retry Logic**: Exponential backoff with configurable retry attempts ### Enhanced Quality (v2.3) - **Structured Logging**: JSON-based logging with child loggers per tool - **Configuration Validation**: Startup validation for all platform configurations - **Platform Expansion**: Full support for 6 platforms (Notion, GitHub Wiki, Obsidian, Confluence, Slack, Discord) - **AST Memoization**: Cached code analysis for improved performance - **Test Coverage**: 81 tests with 85%+ coverage on core modules ### AI-Powered Analysis (v2.4) - **Claude AI Integration**: Use Claude AI for enhanced design decision analysis - **Smart Summarization**: AI-generated insights and recommendations - **Fallback Support**: Automatic fallback to pattern-based analysis when AI unavailable - **Optional Feature**: Enable with `useAI: true` parameter ### AI Code Analysis (v2.5) - **AI-Powered Code Review**: Deep code analysis with quality, security, and performance insights - **Issue Detection**: Identify potential bugs, security vulnerabilities, and code smells - **Improvement Suggestions**: AI-generated recommendations for better code - **Works with AST**: Combines AI insights with AST-based analysis for comprehensive results ### Session History (v2.6) - **Persistent Storage**: Save coding sessions to local JSON files - **CRUD Operations**: Create, read, update, delete sessions - **Search & Filter**: Find past sessions by keyword, tags, or date - **Statistics**: Track total sessions, code contexts, and design decisions ### Session Export & Project Profiles (v2.7) - **Session Export**: Export sessions to Markdown, JSON, or HTML formats - **Multiple Templates**: Default, minimal, detailed, and report templates - **Project Profiles**: Manage project-specific settings and configurations - **Publishing Config**: Default platforms and settings per project - **Code Analysis Config**: Language preferences and diagram types - **Documentation Config**: Default document types, language, author info - **Team Management**: Store team member information per project ## Installation ### Claude Code (Recommended) ```bash claude mcp add vibe-coding-mcp npx vibe-coding-mcp ``` ### npm ```bash npm install -g vibe-coding-mcp ``` ### Claude Desktop Add to `claude_desktop_config.json`: **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "vibe-coding-mcp": { "command": "npx", "args": ["vibe-coding-mcp"] } } } ``` ## Environment Variables ```env # Anthropic API (optional, for AI-powered analysis) ANTHROPIC_API_KEY=your_anthropic_api_key_here # Notion API (optional) NOTION_API_KEY=your_notion_api_key_here NOTION_DATABASE_ID=your_database_id_here # GitHub (optional, for Wiki publishing) GITHUB_TOKEN=your_github_token_here GITHUB_REPO=owner/repo # Confluence (optional) CONFLUENCE_BASE_URL=https://your-domain.atlassian.net CONFLUENCE_USERNAME=your_email@example.com CONFLUENCE_API_TOKEN=your_api_token_here CONFLUENCE_SPACE_KEY=YOURSPACE # Slack (optional, webhook URL passed via tool parameter) SLACK_WEBHOOK_URL=https://hooks.slack.com/services/... # Discord (optional, webhook URL passed via tool parameter) DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/... ``` ## Demo Scenarios ### 1. Generate README and Publish to Notion ``` User: Collect the code we wrote today and create a README, then publish to Notion. Claude: [Uses collect_code_context → generate_dev_document → normalize_for_platform → publish_document] ``` ### 2. Create Design Decision Docs for GitHub Wiki ``` User: Summarize our design decisions and publish to GitHub Wiki. Claude: [Uses summarize_design_decisions → generate_dev_document → normalize_for_platform → publish_document] ``` ### 3. Daily Vibe Coding Log ``` User: Create a session log for today's work. Claude: [Uses collect_code_context → create_session_log] ``` ## Supported Platforms - **Notion**: Full API integration with page creation - **GitHub Wiki**: Git-based wiki updates - **Obsidian**: Local vault file storage with frontmatter support - **Confluence**: Atlassian Confluence page publishing - **Slack**: Webhook-based message publishing - **Discord**: Webhook-based message publishing ## Project Structure ``` src/ ├── stdio.ts # MCP server entry point (stdio transport) ├── index.ts # HTTP/SSE server entry point ├── core/ │ ├── schemas.ts # Zod validation schemas │ ├── errors.ts # Structured error classes │ ├── cache.ts # LRU cache & memoization │ ├── security.ts # Path traversal, SSRF, timeout utilities │ ├── logger.ts # Structured JSON logging │ └── config.ts # Platform configuration validation ├── tools/ # 10 MCP tools ├── platforms/ # Notion, GitHub Wiki, Obsidian, Confluence, Slack, Discord ├── types/ # TypeScript interfaces └── utils/ # Markdown, AST, diagram utilities ``` ## Development ```bash # Watch mode npm run dev # Build npm run build # Start (HTTP/SSE mode) npm start # Start (stdio mode for Claude Desktop) npm run stdio # Run tests npm test # Run tests with coverage npm run test:coverage ``` ## Dependencies | Package | Purpose | |---------|---------| | `@modelcontextprotocol/sdk` | MCP server SDK | | `@notionhq/client` | Notion API integration | | `zod` | Input validation | | `typescript` | TypeScript compiler | ## License MIT