lharillo/serenity-mcp repository overview

⁠Serenity Star MCP Server

Official Model Context Protocol (MCP) server for Serenity Star AI Platform.

⁠Quick Start

docker pull lharillo/serenity-mcp:latest
docker run -d -p 8080:8080 lharillo/serenity-mcp:latest

⁠Features

• 35+ Tools - Complete CRUD for agents, models, conversations
• Header-Based Auth - Secure API key authentication
• HTTP/SSE Transport - Real-time Server-Sent Events
• Stateless - No credentials stored server-side
• Production Ready - Built with .NET 10, Microsoft MCP SDK

⁠MCP Client Configuration

{
  "mcpServers": {
    "serenity-star": {
      "url": "http://localhost:8080/sse",
      "headers": {
        "X-Serenity-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

⁠Available Tools

Agent Management:

• Create, update, publish agents
• Execute with messages (stateful/stateless)
• Manage conversations & context
• Token usage & analytics

Model Discovery:

• List 100+ AI models
• Get UUIDs & capabilities
• GPT-4, Claude, Gemini support

Document Upload:

• Volatile knowledge upload
• Base64 file support
• Temporary agent context

⁠Endpoints

• /sse - Server-Sent Events (MCP protocol)
• /message - Send messages
• /health - Health check
• /docs - Interactive docs

⁠Security

• No API keys stored in container
• Auth via client headers
• Transparent proxy
• Non-root user

⁠Links

• Live Demo: https://mcp.starkcloud.cc/serenitystar/docs⁠
• GitHub: https://github.com/lharillo/serenity-mcp⁠
• Release: https://github.com/lharillo/serenity-mcp/releases/tag/v1.0.0⁠
• Docs: https://docs.serenitystar.ai⁠
• MCP Protocol: https://modelcontextprotocol.io⁠

Built by Subgen AI