MCP server for automatically collecting, summarizing, documenting, and publishing vibe coding sessions
npm install vibe-coding-mcpMCP server that automatically collects, summarizes, documents, and publishes code and design decisions created during vibe coding sessions.
This MCP server provides 15 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 |
| muse_git | Git integration - status, log, diff, branch, snapshot, design decision extraction |
| muse_session_stats | Session analytics dashboard with productivity insights and trends |
| muse_auto_tag | AI-powered auto-tagging for sessions based on content analysis |
| muse_template | Custom template management for documents and reports |
| muse_batch | Batch operations to execute multiple tools in sequence or parallel |
useAI: true parameter{{variable}}, ${variable}, {variable} formats$ref syntax``bash`
claude mcp add vibe-coding-mcp npx vibe-coding-mcp
`bash`
npm install -g vibe-coding-mcp
Add to claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json
Windows:
`json`
{
"mcpServers": {
"vibe-coding-mcp": {
"command": "npx",
"args": ["vibe-coding-mcp"]
}
}
}
`envAnthropic API (optional, for AI-powered analysis)
ANTHROPIC_API_KEY=your_anthropic_api_key_here
Demo Scenarios
$3
`
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]
`$3
`
User: Summarize our design decisions and publish to GitHub Wiki.Claude: [Uses summarize_design_decisions → generate_dev_document → normalize_for_platform → publish_document]
`$3
`
User: Create a session log for today's work.Claude: [Uses collect_code_context → create_session_log]
`$3
`
User: Capture my current Git state and create a session with design decisions from commits.Claude: [Uses muse_git(action='snapshot') → muse_git(action='extractDecisions') → muse_session_history(action='save')]
`$3
`
User: Export all my sessions from this week with Git information.Claude: [Uses muse_git(action='linkToSession') → muse_export_session(format='markdown')]
`$3
`
User: Show me my coding productivity statistics for this month.Claude: [Uses muse_session_stats(action='overview') → muse_session_stats(action='productivity') → muse_session_stats(action='trends')]
`$3
`
User: Analyze my sessions and suggest relevant tags.Claude: [Uses muse_auto_tag(action='suggest') → muse_auto_tag(action='apply')]
`$3
`
User: Create a weekly report using the team report template.Claude: [Uses muse_template(action='apply', templateId='weekly-report') → muse_publish_document]
`$3
`
User: Analyze this code, generate docs, and publish to Notion in one go.Claude: [Uses muse_batch(action='execute', operations=[
{tool: 'muse_analyze_code', params: {...}},
{tool: 'muse_generate_dev_document', params: {...}, dependsOn: ['op_0']},
{tool: 'muse_publish_document', params: {...}, dependsOn: ['op_1']}
])]
`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/ # 15 MCP tools
├── platforms/ # Notion, GitHub Wiki, Obsidian, Confluence, Slack, Discord
├── types/ # TypeScript interfaces
└── utils/
├── markdown.ts # Markdown processing
├── astParser.ts # AST parsing for TypeScript, Python, Go
├── diagramGenerator.ts # Mermaid diagram generation
├── gitExecutor.ts # Safe Git command execution
└── gitParsers.ts # Git output parsing utilities
`Development
`bash
Watch mode
npm run devBuild
npm run buildStart (HTTP/SSE mode)
npm startStart (stdio mode for Claude Desktop)
npm run stdioRun tests
npm testRun 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 |MIT