Headlesshost MCP Server
A comprehensive Model Context Protocol (MCP) server that provides complete communication with the Headlesshost platform API endpoints. This server enables AI assistants to interact with all aspects of the Headlesshost platform including user management, content site operations, staging site management, content generation, analytics, and system administration.
Demo
https://www.youtube.com/watch?v=xGGwcrI7gSo&feature=youtu.be
Installation
-
Clone this repository
-
Install dependencies:
npm install -
Build the server:
npm run build
Usage
With Claude Desktop
Add this configuration to your Claude Desktop config file:
On a Mac (edit or create this file).
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
For local development
{
"mcpServers": {
"Headlesshost-cms": {
"command": "node",
"args": ["/path/to/Headlesshost-mcp/build/index.js"],
"env": {
"HEADLESSHOST_API_KEY": "your-auth-token"
}
}
}
}
For automated install via npx
{
"mcpServers": {
"headlesshost-cms": {
"command": "npx",
"args": ["headlesshost-mcp-server"],
"env": {
"HEADLESSHOST_API_KEY": "sk_live_your_api_key"
}
}
}
}
With Other MCP Clients
This server is compatible with any MCP client including:
- VS Code with MCP extensions
- Zed Editor
- Continue.dev
- Custom MCP implementations
Configure your client to use:
- Command:
node - Args:
["/path/to/Headlesshost.mcp/build/index.js"] - Environment: Set
HEADLESSHOST_API_KEY
Development
Build the server:
npm run build
Run the server directly:
npm start
Run the MCP inspector for debugging:
npm run inspector
Resources
The server provides 2 resources for configuration and monitoring:
- API Configuration: Current Headlesshost API settings and endpoints
- API Health Status: Real-time connectivity and health information
Error Handling
The server includes comprehensive error handling with:
- API authentication validation
- Network connectivity checks
- Detailed error messages and troubleshooting information
- Graceful fallbacks for API timeouts
Security
- API key authentication required for all operations
- Secure environment variable handling
- Request/response logging for audit trails
- Input validation and sanitization