Initial commit

skills/mcp-server-creator/workflow/phase-6-testing.md

@@ -0,0 +1,60 @@
+# Phase 6: Testing & Validation
+
+**Purpose**: Verify server works correctly before deployment
+
+## Testing Workflow
+
+### 1. Build Check (TypeScript)
+
+```bash
+npm run build
+# Should complete without errors
+# Verify build/index.js exists
+```
+
+### 2. MCP Inspector Testing
+
+```bash
+# Install MCP Inspector
+npx @modelcontextprotocol/inspector node build/index.js
+
+# Or for Python
+npx @modelcontextprotocol/inspector uv run main.py
+```
+
+- Opens browser interface to test tools/resources
+- Validates schemas and responses
+- Great for debugging before Claude integration
+
+### 3. Claude Desktop Integration Test
+
+- Add to claude_desktop_config.json
+- Completely restart Claude Desktop
+- Check logs: `~/Library/Logs/Claude/mcp*.log`
+- Look for server in "🔌" (attachments) menu
+
+### 4. Functional Testing in Claude
+
+Test with natural language queries:
+- "Use [server-name] to [perform action]"
+- "Can you [tool description]?"
+- Verify tool appears in suggestions
+- Check response accuracy
+
+## Debugging Common Issues
+
+| Issue | Cause | Solution |
+|-------|-------|----------|
+| Server not detected | Invalid path | Use absolute path, verify file exists |
+| Tools don't appear | Build not run | Run `npm run build` |
+| "Server error" | stdout logging | Remove console.log, use console.error |
+| Connection timeout | Server crash | Check mcp-server-NAME.log for errors |
+| Invalid config | JSON syntax | Validate JSON, check quotes/commas |
+
+## Output
+
+Validated, working MCP server with test results
+
+## Transition
+
+Proceed to Phase 7 (Documentation & Handoff)