vibe-coding-mcp 2.3.0

package/README.md

@@ -0,0 +1,179 @@
+# 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 7 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 |
+
+### 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
+
+## Installation
+
+### Claude Code (Recommended)
+
+```bash
+claude mcp add vibe-coding-mcp npx github:MUSE-CODE-SPACE/vibe-coding-mcp
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "vibe-coding-mcp": {
+      "command": "npx",
+      "args": ["github:MUSE-CODE-SPACE/vibe-coding-mcp"]
+    }
+  }
+}
+```
+
+## Environment Variables
+
+```env
+# 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
+
+```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

package/dist/__tests__/collectCodeContext.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=collectCodeContext.test.d.ts.map

package/dist/__tests__/collectCodeContext.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectCodeContext.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/collectCodeContext.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/collectCodeContext.test.js

@@ -0,0 +1,139 @@
+import { collectCodeContext } from '../tools/collectCodeContext.js';
+describe('collectCodeContext', () => {
+    describe('basic functionality', () => {
+        it('should create a context with provided code blocks', () => {
+            const result = collectCodeContext({
+                codeBlocks: [
+                    { language: 'typescript', code: 'const x = 1;' }
+                ],
+                conversationSummary: 'Test summary'
+            });
+            expect(result.context).toBeDefined();
+            expect(result.context.codeBlocks).toHaveLength(1);
+            expect(result.context.conversationSummary).toBe('Test summary');
+            expect(result.context.sessionId).toBeDefined();
+            expect(result.context.timestamp).toBeDefined();
+        });
+        it('should extract code blocks from raw text', () => {
+            const rawText = `
+Here is some code:
+\`\`\`javascript
+function hello() {
+  console.log('Hello');
+}
+\`\`\`
+      `;
+            const result = collectCodeContext({
+                rawText,
+                conversationSummary: 'Extracted from raw text'
+            });
+            expect(result.context.codeBlocks).toHaveLength(1);
+            expect(result.context.codeBlocks[0].language).toBe('javascript');
+        });
+    });
+    describe('language detection', () => {
+        it('should auto-detect TypeScript', () => {
+            const result = collectCodeContext({
+                codeBlocks: [
+                    { language: '', code: 'interface User { name: string; age: number; }' }
+                ],
+                conversationSummary: 'TypeScript detection',
+                autoDetectLanguage: true
+            });
+            expect(result.context.codeBlocks[0].language).toBe('typescript');
+        });
+        it('should auto-detect Python', () => {
+            const result = collectCodeContext({
+                codeBlocks: [
+                    { language: '', code: 'def hello():\n    print("Hello")' }
+                ],
+                conversationSummary: 'Python detection',
+                autoDetectLanguage: true
+            });
+            expect(result.context.codeBlocks[0].language).toBe('python');
+        });
+        it('should auto-detect SQL', () => {
+            const result = collectCodeContext({
+                codeBlocks: [
+                    { language: '', code: 'SELECT * FROM users WHERE id = 1' }
+                ],
+                conversationSummary: 'SQL detection'
+            });
+            expect(result.context.codeBlocks[0].language).toBe('sql');
+        });
+    });
+    describe('duplicate removal', () => {
+        it('should remove duplicate code blocks', () => {
+            const result = collectCodeContext({
+                codeBlocks: [
+                    { language: 'javascript', code: 'const x = 1;' },
+                    { language: 'javascript', code: 'const x = 1;' },
+                    { language: 'javascript', code: 'const y = 2;' }
+                ],
+                conversationSummary: 'Duplicate test',
+                removeDuplicates: true
+            });
+            expect(result.context.codeBlocks).toHaveLength(2);
+            expect(result.warnings).toContain('Removed 1 duplicate code block(s)');
+        });
+        it('should keep duplicates when removeDuplicates is false', () => {
+            const result = collectCodeContext({
+                codeBlocks: [
+                    { language: 'javascript', code: 'const x = 1;' },
+                    { language: 'javascript', code: 'const x = 1;' }
+                ],
+                conversationSummary: 'Keep duplicates',
+                removeDuplicates: false
+            });
+            expect(result.context.codeBlocks).toHaveLength(2);
+        });
+    });
+    describe('statistics', () => {
+        it('should include stats when includeStats is true', () => {
+            const result = collectCodeContext({
+                codeBlocks: [
+                    { language: 'javascript', code: 'const x = 1;\nconst y = 2;' },
+                    { language: 'python', code: 'x = 1' }
+                ],
+                conversationSummary: 'Stats test',
+                includeStats: true
+            });
+            expect(result.stats).toBeDefined();
+            expect(result.stats?.totalBlocks).toBe(2);
+            expect(result.stats?.languageBreakdown).toEqual({
+                javascript: 1,
+                python: 1
+            });
+        });
+    });
+    describe('tags', () => {
+        it('should auto-add language tags', () => {
+            const result = collectCodeContext({
+                codeBlocks: [
+                    { language: 'typescript', code: 'const x: number = 1;' }
+                ],
+                conversationSummary: 'Tag test',
+                tags: ['custom-tag']
+            });
+            expect(result.context.tags).toContain('custom-tag');
+            expect(result.context.tags).toContain('typescript');
+        });
+    });
+    describe('validation', () => {
+        it('should warn on empty summary', () => {
+            const result = collectCodeContext({
+                codeBlocks: [{ language: 'js', code: 'x' }],
+                conversationSummary: ''
+            });
+            expect(result.warnings).toContain('Conversation summary is empty');
+        });
+        it('should warn on empty code block', () => {
+            const result = collectCodeContext({
+                codeBlocks: [{ language: 'js', code: '' }],
+                conversationSummary: 'Test'
+            });
+            expect(result.warnings).toContain('Code block 1 is empty');
+        });
+    });
+});
+//# sourceMappingURL=collectCodeContext.test.js.map

package/dist/__tests__/collectCodeContext.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectCodeContext.test.js","sourceRoot":"","sources":["../../src/__tests__/collectCodeContext.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/createSessionLog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createSessionLog.test.d.ts.map

package/dist/__tests__/createSessionLog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSessionLog.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/createSessionLog.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/createSessionLog.test.js

@@ -0,0 +1,130 @@
+import { createSessionLog } from '../tools/createSessionLog.js';
+describe('createSessionLog', () => {
+    describe('basic functionality', () => {
+        it('should create a session log with required fields', async () => {
+            const result = await createSessionLog({
+                title: 'Test Session',
+                summary: 'This is a test summary'
+            });
+            expect(result.sessionLog).toBeDefined();
+            expect(result.sessionLog.sessionId).toBeDefined();
+            expect(result.sessionLog.date).toBeDefined();
+            expect(result.sessionLog.title).toBe('Test Session');
+            expect(result.sessionLog.summary).toBe('This is a test summary');
+            expect(result.content).toBeDefined();
+        });
+        it('should include duration when provided', async () => {
+            const result = await createSessionLog({
+                title: 'Test Session',
+                summary: 'Test summary',
+                duration: 3600
+            });
+            expect(result.sessionLog.duration).toBe(3600);
+            expect(result.content).toContain('60 minutes');
+        });
+    });
+    describe('log formats', () => {
+        it('should create markdown log by default', async () => {
+            const result = await createSessionLog({
+                title: 'Test',
+                summary: 'Summary'
+            });
+            expect(result.content).toContain('#');
+            expect(result.content).toContain('Test');
+        });
+        it('should create JSON log when requested', async () => {
+            const result = await createSessionLog({
+                title: 'Test',
+                summary: 'Summary',
+                options: {
+                    logType: 'session',
+                    format: 'json'
+                }
+            });
+            expect(() => JSON.parse(result.content)).not.toThrow();
+            const parsed = JSON.parse(result.content);
+            expect(parsed.title).toBe('Test');
+        });
+        it('should create daily log type', async () => {
+            const result = await createSessionLog({
+                title: 'Daily',
+                summary: 'Daily summary',
+                options: {
+                    logType: 'daily',
+                    format: 'markdown'
+                }
+            });
+            expect(result.content).toContain('Daily Vibe Coding Log');
+        });
+    });
+    describe('code contexts', () => {
+        it('should include code contexts in log', async () => {
+            const result = await createSessionLog({
+                title: 'Test',
+                summary: 'Summary',
+                codeContexts: [
+                    {
+                        sessionId: '1',
+                        timestamp: new Date().toISOString(),
+                        codeBlocks: [{ language: 'typescript', code: 'const x = 1;' }],
+                        conversationSummary: 'Created a variable'
+                    }
+                ]
+            });
+            expect(result.content).toContain('Code Contexts');
+            expect(result.content).toContain('const x = 1;');
+        });
+    });
+    describe('design decisions', () => {
+        it('should include design decisions in log', async () => {
+            const result = await createSessionLog({
+                title: 'Test',
+                summary: 'Summary',
+                designDecisions: [
+                    {
+                        id: '1',
+                        title: 'Use TypeScript',
+                        description: 'Decided to use TypeScript',
+                        rationale: 'Type safety',
+                        alternatives: ['JavaScript'],
+                        timestamp: new Date().toISOString(),
+                        category: 'implementation'
+                    }
+                ]
+            });
+            expect(result.content).toContain('Design Decisions');
+            expect(result.content).toContain('Use TypeScript');
+        });
+    });
+    describe('tags', () => {
+        it('should include tags in log', async () => {
+            const result = await createSessionLog({
+                title: 'Test',
+                summary: 'Summary',
+                tags: ['react', 'typescript', 'api']
+            });
+            expect(result.sessionLog.tags).toContain('react');
+            expect(result.content).toContain('#react');
+            expect(result.content).toContain('#typescript');
+        });
+    });
+    describe('edge cases', () => {
+        it('should handle empty code contexts array', async () => {
+            const result = await createSessionLog({
+                title: 'Test',
+                summary: 'Summary',
+                codeContexts: []
+            });
+            expect(result.content).toBeDefined();
+        });
+        it('should handle empty design decisions array', async () => {
+            const result = await createSessionLog({
+                title: 'Test',
+                summary: 'Summary',
+                designDecisions: []
+            });
+            expect(result.content).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=createSessionLog.test.js.map

package/dist/__tests__/createSessionLog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSessionLog.test.js","sourceRoot":"","sources":["../../src/__tests__/createSessionLog.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/generateDevDocument.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generateDevDocument.test.d.ts.map

package/dist/__tests__/generateDevDocument.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateDevDocument.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/generateDevDocument.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/generateDevDocument.test.js

@@ -0,0 +1,174 @@
+import { generateDevDocument } from '../tools/generateDevDocument.js';
+describe('generateDevDocument', () => {
+    describe('README generation', () => {
+        it('should generate a basic README', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test Project',
+                description: 'A test project description'
+            });
+            expect(result.document).toContain('# Test Project');
+            expect(result.document).toContain('A test project description');
+            expect(result.documentType).toBe('README');
+            expect(result.generatedAt).toBeDefined();
+            expect(result.wordCount).toBeGreaterThan(0);
+        });
+        it('should include table of contents when requested', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test',
+                includeTableOfContents: true
+            });
+            expect(result.document).toContain('## Table of Contents');
+        });
+        it('should include features list', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test',
+                features: ['Feature 1', 'Feature 2', 'Feature 3']
+            });
+            expect(result.document).toContain('## Features');
+            expect(result.document).toContain('- Feature 1');
+            expect(result.document).toContain('- Feature 2');
+            expect(result.document).toContain('- Feature 3');
+        });
+        it('should include custom installation steps', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test',
+                installation: {
+                    requirements: ['Node.js 18+', 'npm'],
+                    steps: ['npm install', 'npm run build']
+                }
+            });
+            expect(result.document).toContain('npm install');
+            expect(result.document).toContain('npm run build');
+            expect(result.document).toContain('Node.js 18+');
+        });
+        it('should include badges', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test',
+                badges: [
+                    { label: 'version', message: '1.0.0', color: 'blue' }
+                ]
+            });
+            expect(result.document).toContain('img.shields.io');
+        });
+        it('should include API reference', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test',
+                apiReference: [
+                    {
+                        name: 'myFunction',
+                        description: 'Does something',
+                        params: ['arg1: string', 'arg2: number'],
+                        returns: 'boolean'
+                    }
+                ]
+            });
+            expect(result.document).toContain('`myFunction`');
+            expect(result.document).toContain('Does something');
+            expect(result.document).toContain('arg1: string');
+            expect(result.document).toContain('**Returns:** boolean');
+        });
+        it('should include FAQ section', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test',
+                faq: [
+                    { question: 'How does it work?', answer: 'It works well.' }
+                ]
+            });
+            expect(result.document).toContain('## FAQ');
+            expect(result.document).toContain('How does it work?');
+            expect(result.document).toContain('It works well.');
+        });
+    });
+    describe('Korean language support', () => {
+        it('should use Korean headers when language is ko', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: '테스트 프로젝트',
+                language: 'ko',
+                features: ['기능 1']
+            });
+            expect(result.document).toContain('## 개요');
+            expect(result.document).toContain('## 기능');
+            expect(result.document).toContain('## 설치');
+        });
+    });
+    describe('DESIGN document', () => {
+        it('should generate a design document with metadata table', () => {
+            const result = generateDevDocument({
+                documentType: 'DESIGN',
+                title: 'System Design',
+                author: 'Test Author',
+                version: '1.0'
+            });
+            expect(result.document).toContain('# System Design');
+            expect(result.document).toContain('**Author**');
+            expect(result.document).toContain('Test Author');
+            expect(result.document).toContain('**Version**');
+        });
+    });
+    describe('TUTORIAL document', () => {
+        it('should generate a tutorial with steps', () => {
+            const result = generateDevDocument({
+                documentType: 'TUTORIAL',
+                title: 'Getting Started',
+                codeContexts: [
+                    {
+                        sessionId: '1',
+                        timestamp: new Date().toISOString(),
+                        codeBlocks: [{ language: 'bash', code: 'npm install' }],
+                        conversationSummary: 'First, install dependencies',
+                        tags: ['setup']
+                    }
+                ]
+            });
+            expect(result.document).toContain('# Getting Started');
+            expect(result.document).toContain('Step 1');
+            expect(result.document).toContain('npm install');
+        });
+    });
+    describe('CHANGELOG document', () => {
+        it('should generate a changelog', () => {
+            const result = generateDevDocument({
+                documentType: 'CHANGELOG',
+                version: '1.0.0',
+                codeContexts: [
+                    {
+                        sessionId: '1',
+                        timestamp: new Date().toISOString(),
+                        codeBlocks: [],
+                        conversationSummary: 'Added new feature X'
+                    }
+                ]
+            });
+            expect(result.document).toContain('# Changelog');
+            expect(result.document).toContain('[1.0.0]');
+            expect(result.document).toContain('Added new feature X');
+        });
+    });
+    describe('output metadata', () => {
+        it('should include sections list', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test'
+            });
+            expect(result.sections).toBeDefined();
+            expect(result.sections.length).toBeGreaterThan(0);
+        });
+        it('should calculate word count', () => {
+            const result = generateDevDocument({
+                documentType: 'README',
+                title: 'Test',
+                description: 'This is a description with multiple words.'
+            });
+            expect(result.wordCount).toBeGreaterThan(10);
+        });
+    });
+});
+//# sourceMappingURL=generateDevDocument.test.js.map