JoySafeter

v1.0.0•Coding Agents•stable

🚀 JoySafeter: An enterprise AI Agent Platform—Not just chatting. building、running、testing, and tracing autonomous Agent Teams with visual orchestration...

a2aagentagent-platformagent-studioagents
Share:
274
Stars
0
Downloads
0
Weekly
0/5

What is JoySafeter?

JoySafeter is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 🚀 joysafeter: an enterprise ai agent platform—not just chatting. building、running、testing, and tracing autonomous agent teams with visual orchestration...

🚀 JoySafeter: An enterprise AI Agent Platform—Not just chatting. building、running、testing, and tracing autonomous Agent Teams with visual orchestration...

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 🚀 JoySafeter: An enterprise AI Agent Platform—Not just chatt

Use Cases

Build and test autonomous agent teams
Trace agent execution visually
Manage multi-agent workflows
jd-opensource

Maintainer

LicenseApache-2.0
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx joysafeter

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use JoySafeter

JoySafeter is an enterprise AI Agent platform that lets you build, run, test, and trace autonomous agent teams with visual orchestration. It integrates over 200 tools via the MCP protocol—including pre-bundled security tools like Nmap, Nuclei, and Trivy—and supports multi-agent collaboration with persistent memory across sessions. Developers and security engineers use it to automate penetration testing, APK vulnerability analysis, document review, and complex multi-step workflows without writing glue code.

Prerequisites

  • Docker and Docker Compose installed on your system
  • Git to clone the repository
  • A supported LLM provider API key (e.g. OpenAI, Anthropic, or a compatible local endpoint)
  • At least 8 GB RAM recommended for running the full stack (frontend, backend, PostgreSQL, Redis)
  • An MCP-compatible client to interact with the exposed MCP services
1

Clone the repository

Clone the JoySafeter repository to your local machine.

git clone https://github.com/jd-opensource/JoySafeter.git
cd JoySafeter
2

Run the quick-start script

Execute the provided quick-start script which sets up all services including the frontend, backend API, PostgreSQL, and Redis automatically.

./deploy/quick-start.sh
3

Configure your LLM provider

After the stack starts, open the web UI at http://localhost:3000 and navigate to Settings to enter your LLM provider credentials (API key, model endpoint, and model name).

4

Access the platform and explore pre-built agents

Browse to http://localhost:3000 to access the visual orchestration interface. JoySafeter ships with 30+ pre-built skills and security agent templates you can use immediately or customize.

5

Connect via MCP

The MCP service runs alongside the backend. Point your MCP client at the JoySafeter MCP endpoint to expose agent capabilities as MCP tools. Check the API docs at http://localhost:8000/docs for available endpoints.

{
  "mcpServers": {
    "joysafeter": {
      "command": "npx",
      "args": ["joysafeter"],
      "env": {
        "JOYSAFETER_API_URL": "http://localhost:8000"
      }
    }
  }
}
6

Start the middleware only (lightweight option)

If you only need PostgreSQL, Redis, and the MCP service without the full frontend, use the middleware-only script.

./deploy/scripts/start-middleware.sh

JoySafeter Examples

Client configuration

MCP client configuration pointing to a locally running JoySafeter instance.

{
  "mcpServers": {
    "joysafeter": {
      "command": "npx",
      "args": ["joysafeter"],
      "env": {
        "JOYSAFETER_API_URL": "http://localhost:8000"
      }
    }
  }
}

Prompts to try

Example prompts once JoySafeter agents are connected.

- "Upload this APK file and run a full OWASP Mobile Top 10 vulnerability analysis"
- "Create a penetration testing agent for https://example.com and report discovered endpoints"
- "Run Nmap on 192.168.1.0/24 and summarize open services"
- "Analyze this Docker image with Trivy and list all critical CVEs"
- "Start a multi-agent workflow: one manager agent coordinating three worker agents for recon, exploitation, and reporting"

Troubleshooting JoySafeter

Services fail to start or database connection errors on first run

Run `docker compose logs` to identify the failing service. PostgreSQL may need 30-60 seconds to initialize before the backend connects. Run `./deploy/quick-start.sh` again after PostgreSQL is fully healthy.

Frontend at localhost:3000 shows blank page or CSP errors

Check that NEXT_PUBLIC_CSP_CONNECT_SRC_EXTRA is set correctly in the frontend environment config to include your backend host. For remote deployments, configure the nginx.conf with the correct backend IP and port.

LLM API calls fail inside agents

Verify your LLM credentials in Settings → Model Configuration. Ensure the model endpoint URL is reachable from inside the Docker network (use the host machine's IP rather than localhost when running Docker).

Frequently Asked Questions about JoySafeter

What is JoySafeter?

JoySafeter is a Model Context Protocol (MCP) server that 🚀 joysafeter: an enterprise ai agent platform—not just chatting. building、running、testing, and tracing autonomous agent teams with visual orchestration... It connects AI assistants to external tools and data sources through a standardized interface.

How do I install JoySafeter?

Follow the installation instructions on the JoySafeter GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with JoySafeter?

JoySafeter works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is JoySafeter free to use?

Yes, JoySafeter is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "joysafeter": { "command": "npx", "args": ["-y", "joysafeter"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use JoySafeter?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides