1.5 KiB
1.5 KiB
Phase 6: Testing & Validation
Purpose: Verify server works correctly before deployment
Testing Workflow
1. Build Check (TypeScript)
npm run build
# Should complete without errors
# Verify build/index.js exists
2. MCP Inspector Testing
# 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)