Samurai MCP Super Server

What is Samurai MCP Super Server?

Samurai MCP Super Server is a comprehensive Model Context Protocol super server built with a plugin‑based architecture, secure vault integration, and a real‑time web dashboard. It supports multiple LLM providers, rate limiting, logging, and a plugin marketplace, and is targeted at developers building modular AI‑enabled applications.

How to use Samurai MCP Super Server?

Clone the repository, run go run samurai.go setup to prepare the environment, then go run samurai.go dev to start PostgreSQL and the backend server. Verify with go run samurai.go status. The server exposes endpoints on port 8080 (health, API, etc.) and uses a .env file for configuration.

Key features of Samurai MCP Super Server

• Plugin‑based modular MCP instances for different services
• Secure vault integration for API key storage and encryption
• Real‑time web dashboard for live monitoring and management
• Per‑provider and per‑plugin rate limiting and throttling
• Comprehensive request/response logging with queryable history
• Plugin marketplace and A/B testing framework (planned)

Use cases of Samurai MCP Super Server

• Deploying a central MCP gateway with pluggable service integrations (e.g., SMS via Twilio)
• Managing multiple LLM providers with secure API key storage and usage quotas
• Building and testing different LLM configurations inside an A/B testing framework
• Monitoring and analyzing API usage, costs, and performance via the dashboard and metrics
• Developing custom plugins using the provided SDK/CLI with hot‑reloading support

FAQ from Samurai MCP Super Server

What are the prerequisites to run Samurai MCP Super Server?

Go 1.21+, Docker Desktop, and Git are required.

How do I set up the development environment?

Run go run samurai.go setup which creates directories, copies .env.example to .env, downloads Go dependencies, and pulls required Docker images.

What development commands are available?

Commands include dev, setup, build, test, status, logs, stop, and clean – all invoked via go run samurai.go <command>.

How can I configure the environment and logs?

Copy .env.example to .env and set variables for server port, database credentials, JWT secret, log level (debug/info/warn/error), and log format (json/console).

What service endpoints does the server expose?

Health check at /health, readiness at /health/ready, REST API base at /api/v1, and PostgreSQL on localhost:5432.