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

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

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/                # 7 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