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:

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)

claude mcp add vibe-coding-mcp npx vibe-coding-mcp

npm

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

{
  "mcpServers": {
    "vibe-coding-mcp": {
      "command": "npx",
      "args": ["vibe-coding-mcp"]
    }
  }
}

Environment Variables

# 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

# 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

License

MIT