name	mcp-observability-runbook
description	Define operational telemetry and incident runbooks for MCP servers: logs, metrics, alerts, and recovery paths.

MCP Observability Runbook

When to Use

Add long-running or high-risk tools.
Prepare production-like internal deployment.
Investigate recurring failures.

Procedure

Define critical metrics
- Request count, error rate, latency p95/p99.
- Tool-level timeout rate and validation failure rate.
Standardize logs
- Structured logs with requestId/toolName/status/elapsedMs.
- No secrets or raw sensitive payloads.
Alert policy
- Thresholds for error spikes and sustained latency.
Incident runbook
- Detect -> triage -> mitigate -> recover -> postmortem.
- Include rollback/restart/reindex procedures where applicable.
Verification drills
- Simulate timeout and dependency failures.

Output Format

Metrics set
Alert set
Runbook steps with owners

Más de este repositorio

mismo repositorio

key

tvnkhoa/mcp-local

"Browse Bitbucket Cloud repositories and pull requests, read PR diffs, and create pull requests via the {{DISPLAY_NAME}}. Triggers on: list repos/branches/PRs, view a pull request or its diff, open/create a PR. PR creation is gated and supports dryRun."

2026-07-082

db-parameterization-audit

tvnkhoa/mcp-local

Audit SQL construction to ensure parameterized execution, anti-concatenation posture, and read-only safety.

2026-07-082

db-query-budgeting

tvnkhoa/mcp-local

Control DB query budget with timeout, row limits, and concurrency caps to prevent abuse and resource exhaustion.

2026-07-082

mcp-contract-conformance

tvnkhoa/mcp-local

Validate MCP contract stability for tools/list, tools/call, schemas, and backward compatibility before merge or release.

2026-07-082

mcp-error-taxonomy

tvnkhoa/mcp-local

Standardize MCP errors into user-actionable vs developer/internal classes with stable codes and safe messages.

2026-07-082

mcp-host-integration-security

tvnkhoa/mcp-local

Harden MCP host/client integration with token hygiene, scope minimization, transport safeguards, and policy checks.

2026-07-082

name	mcp-observability-runbook
description	Define operational telemetry and incident runbooks for MCP servers: logs, metrics, alerts, and recovery paths.

MCP Observability Runbook

When to Use

Add long-running or high-risk tools.
Prepare production-like internal deployment.
Investigate recurring failures.

Procedure

Define critical metrics
- Request count, error rate, latency p95/p99.
- Tool-level timeout rate and validation failure rate.
Standardize logs
- Structured logs with requestId/toolName/status/elapsedMs.
- No secrets or raw sensitive payloads.
Alert policy
- Thresholds for error spikes and sustained latency.
Incident runbook
- Detect -> triage -> mitigate -> recover -> postmortem.
- Include rollback/restart/reindex procedures where applicable.
Verification drills
- Simulate timeout and dependency failures.

Output Format

Metrics set
Alert set
Runbook steps with owners