# SiteScore MCP Server
MCP (Model Context Protocol) server for website auditing. Analyzes websites for SEO, performance, accessibility, mobile-friendliness, and security using AI-powered analysis.
## Features
- **SEO Analysis**: Title, meta description, headings, canonical tags, Open Graph, structured data
- **Performance**: HTML size, script count, stylesheet analysis
- **Mobile**: Viewport meta tag, touch-friendly patterns
- **Accessibility**: ARIA labels, roles, heading structure, lang attribute
- **Security**: HTTPS, HSTS, X-Frame-Options, CSP, mixed content detection
## Installation
```bash
npm install
npm run build
```
## Usage
### As MCP Server
Add to your MCP client configuration:
```json
{
"mcpServers": {
"sitescore": {
"command": "node",
"args": ["/path/to/sitescore-mcp/dist/index.js"],
"env": {
"ANTHROPIC_API_KEY": "your-api-key"
}
}
}
}
```
### Environment Variables
- `ANTHROPIC_API_KEY` - Required. Your Anthropic API key for AI analysis.
## Tools
### analyze_website
Analyze a website and get a comprehensive audit report.
**Input:**
```json
{
"url": "https://example.com"
}
```
**Output:**
```json
{
"overallScore": 75,
"categories": {
"seo": 80,
"performance": 70,
"mobile": 85,
"accessibility": 65,
"security": 75
},
"summary": "The site has good basic SEO but needs improvement in accessibility and security headers.",
"issues": [
{
"severity": "critical",
"category": "Security",
"title": "Missing Content-Security-Policy",
"description": "The site does not have a Content-Security-Policy header...",
"fix": "Add the header: Content-Security-Policy: default-src 'self'..."
}
]
}
```
## Development
```bash
# Run in development mode
npm run dev
# Run tests
npm run test:dev
# Build for production
npm run build
npm start
```
## License
MIT
