ARES - authorized red-team engagement automation with dashboard, campaign scope, module orchestration, OPSEC controls, encrypted vault, and reporting.
Python active-directorycloud-securitydefensive-validationfastapigood-first-issuemitre-attackopsecreactred-teamreportingsecurity
"""ARES Sovereign MCP Server Engine.
Coordinates protocol negotiation, tool execution, resource streaming,
prompt management, and the 7 Unbreakable Security Guarantees.
"""
from __future__ import annotations
import logging
from collections.abc import Callable, Coroutine
from typing import Any
from ares.mcp.events import McpEventBus
from ares.mcp.prompts import McpPromptRegistry
from ares.mcp.protocol import (
LATEST_PROTOCOL_VERSION,
ErrorCode,
InitializeResult,
JSONRPCError,
JSONRPCRequest,
JSONRPCResponse,
)
from ares.mcp.resources import McpResourceRegistry
from ares.mcp.security import ConfirmationTokenManager, McpRateLimiter
from ares.mcp.tools import McpToolRegistry
logger = logging.getLogger("ares.mcp.server")
class AresMcpServer:
"""Central Sovereign MCP Server for ARES."""
def __init__(
self,
db: Any | None = None,
ws_broadcast: Callable[[str, dict[str, Any]], Coroutine[Any, Any, None]] | None = None,
secret_key: str | None = None,
rate_per_minute: float = 60.0,
) -> None:
self.db = db
self.ws_broadcast = ws_broadcast
self.token_manager = ConfirmationTokenManager(secret_key=secret_key)
self.rate_limiter = McpRateLimiter(rate_per_minute=rate_per_minute)
self.tool_registry = McpToolRegistry(
token_manager=self.token_manager,
db=self.db,
ws_broadcast=self.ws_broadcast,
)
self.resource_registry = McpResourceRegistry(db=self.db)
self.prompt_registry = McpPromptRegistry()
self._initialized = False
async def handle_message(self, message: dict[str, Any]) -> dict[str, Any] | None:
"""Handle incoming JSON-RPC request or notification."""
# 1. Check Rate Limiter
if not self.rate_limiter.allow():
req_id = message.get("id")
return JSONRPCResponse(
id=req_id,
error=JSONRPCError(
code=ErrorCode.RATE_LIMITED.value,
message="Rate limit exceeded. Slow down requests.",
),
).model_dump(exclude_none=True)
# 2. Parse request
try:
req = JSONRPCRequest.model_validate(message)
except Exception as e:
return JSONRPCResponse(
id=message.get("id"),
error=JSONRPCError(code=ErrorCode.INVALID_REQUEST.value, message=f"Invalid JSON-RPC request: {e}"),
).model_dump(exclude_none=True)
method = req.method
params = req.params or {}
# 3. Notification Handling (no id, returns None)
if req.id is None:
if method == "notifications/initialized":
self._initialized = True
logger.info("MCP Client connection initialized successfully.")
return None
# 4. Request Dispatching
try:
if method == "initialize":
result = InitializeResult(
protocolVersion=params.get("protocolVersion", LATEST_PROTOCOL_VERSION)
)
self._initialized = True
return JSONRPCResponse(id=req.id, result=result.model_dump()).model_dump(exclude_none=True)
if method == "ping":
return JSONRPCResponse(id=req.id, result={}).model_dump(exclude_none=True)
# Tools
if method == "tools/list":
tools = self.tool_registry.list_tools()
return JSONRPCResponse(
id=req.id,
result={"tools": [t.model_dump() for t in tools]},
).model_dump(exclude_none=True)
if method == "tools/call":
tool_name = params.get("name")
tool_args = params.get("arguments", {})
if not tool_name:
return JSONRPCResponse(
id=req.id,
error=JSONRPCError(code=ErrorCode.INVALID_PARAMS.value, message="Missing 'name' in tools/call"),
).model_dump(exclude_none=True)
res = await self.tool_registry.call_tool(tool_name, tool_args)
# Emit real-time telemetry to local ARES MCP TUI Monitor
try:
arg_summary = ", ".join(f"{k}={v}" for k, v in list(tool_args.items())[:2])
status_label = "ERROR" if res.isError else "OK"
status_style = "red" if res.isError else "green"
if "scope" in tool_name:
status_label = "BLOCKED: out-of-scope" if res.isError else "ALLOW: in-scope"
elif "dry_run" in tool_name:
status_label = "STAGED"
status_style = "blue"
McpEventBus.emit("CALL", {
"call": f"{tool_name}({arg_summary})",
"status": status_label,
"style": status_style,
})
except Exception as exc:
logger.debug("mcp_event_bus_call_emit_failed", error=str(exc))
return JSONRPCResponse(id=req.id, result=res.model_dump()).model_dump(exclude_none=True)
# Resources
if method == "resources/list":
resources = self.resource_registry.list_resources()
return JSONRPCResponse(
id=req.id,
result={"resources": [r.model_dump() for r in resources]},
).model_dump(exclude_none=True)
if method == "resources/read":
uri = params.get("uri")
if not uri:
return JSONRPCResponse(
id=req.id,
error=JSONRPCError(code=ErrorCode.INVALID_PARAMS.value, message="Missing 'uri' in resources/read"),
).model_dump(exclude_none=True)
res_result = await self.resource_registry.read_resource(uri)
return JSONRPCResponse(id=req.id, result=res_result.model_dump()).model_dump(exclude_none=True)
# Prompts
if method == "prompts/list":
prompts = self.prompt_registry.list_prompts()
return JSONRPCResponse(
id=req.id,
result={"prompts": [p.model_dump() for p in prompts]},
).model_dump(exclude_none=True)
if method == "prompts/get":
prompt_name = params.get("name")
prompt_args = params.get("arguments", {})
if not prompt_name:
return JSONRPCResponse(
id=req.id,
error=JSONRPCError(code=ErrorCode.INVALID_PARAMS.value, message="Missing 'name' in prompts/get"),
).model_dump(exclude_none=True)
p_result = await self.prompt_registry.get_prompt(prompt_name, prompt_args)
return JSONRPCResponse(id=req.id, result=p_result.model_dump()).model_dump(exclude_none=True)
# Unknown Method
return JSONRPCResponse(
id=req.id,
error=JSONRPCError(code=ErrorCode.METHOD_NOT_FOUND.value, message=f"Method not found: '{method}'"),
).model_dump(exclude_none=True)
except Exception as e:
logger.exception("Internal error handling method %s: %s", method, e)
return JSONRPCResponse(
id=req.id,
error=JSONRPCError(
code=ErrorCode.INTERNAL_ERROR.value,
message="Internal MCP server error. Consult system audit logs.",
),
).model_dump(exclude_none=True)