Skip to content

aiskillstore/marketplace / skills/0xdarkmatter/mcp-patterns

mcp-patterns

Verified

Model Context Protocol (MCP) server patterns for building integrations with Claude Code. Triggers on: mcp server, model context protocol, tool handler, mcp resource, mcp tool.

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T16:42:20.474Z",
    "slug": "0xdarkmatter-mcp-patterns",
    "source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/mcp-patterns",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "d5ce5b7e529167f774009d037c88e2f9879a699ef62e68bf98fa09966b7cedac",
    "tree_hash": "b782d19486af182382cbf153f5333ab042b3aeac755b73ff0435198c603e2183",
    "provenance": {
      "model_requested": "gpt-5.5:high",
      "model_effective": "codex:gpt-5.5:high",
      "fallback_chain": [
        {
          "agent": "codex",
          "model": "gpt-5.5",
          "effort": "high",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "mcp-patterns",
    "description": "Patterns and examples for building Model Context Protocol servers with tools, resources, authentication, state, and tests.",
    "summary": "Build MCP server integrations with practical patterns for Claude Code, Codex, and Claude workflows.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "0xDarkMatter",
    "license": "MIT",
    "tags": [
      "mcp",
      "claude-code",
      "server-patterns",
      "integrations",
      "python"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "network",
      "env_access",
      "external_commands"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "No prompt injection, malicious intent, credential exfiltration, or system reconnaissance evidence was found. The static findings are documentation examples, placeholder credential names, public reference URLs, Markdown code fences, and sample MCP configuration snippets.",
    "remediation": [
      {
        "issue": "Placeholder credential examples may be copied with real keys.",
        "suggestion": "Add a note telling users to keep real API keys out of committed configuration files.",
        "severity": "low"
      },
      {
        "issue": "Sample MCP command configuration can be reused without review.",
        "suggestion": "Tell users to verify command paths and arguments before adding a server to Claude Desktop.",
        "severity": "low"
      },
      {
        "issue": "The SQLite cache example does not discuss sensitive data handling.",
        "suggestion": "Add guidance to store only non-sensitive cache data or protect the database path.",
        "severity": "low"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "network",
        "evidence": [
          {
            "file": "references/auth-patterns.md",
            "line_start": 17,
            "line_end": 17
          },
          {
            "file": "references/auth-patterns.md",
            "line_start": 41,
            "line_end": 41
          },
          {
            "file": "SKILL.md",
            "line_start": 130,
            "line_end": 130
          },
          {
            "file": "SKILL.md",
            "line_start": 131,
            "line_end": 131
          },
          {
            "file": "SKILL.md",
            "line_start": 132,
            "line_end": 132
          },
          {
            "file": "SKILL.md",
            "line_start": 133,
            "line_end": 133
          },
          {
            "file": "SKILL.md",
            "line_start": 134,
            "line_end": 134
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "references/auth-patterns.md",
            "line_start": 10,
            "line_end": 10
          },
          {
            "file": "references/auth-patterns.md",
            "line_start": 10,
            "line_end": 10
          },
          {
            "file": "references/auth-patterns.md",
            "line_start": 11,
            "line_end": 11
          },
          {
            "file": "references/auth-patterns.md",
            "line_start": 12,
            "line_end": 12
          },
          {
            "file": "references/auth-patterns.md",
            "line_start": 18,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 95,
            "line_end": 95
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 52
          },
          {
            "file": "SKILL.md",
            "line_start": 52,
            "line_end": 56
          },
          {
            "file": "SKILL.md",
            "line_start": 56,
            "line_end": 66
          },
          {
            "file": "SKILL.md",
            "line_start": 66,
            "line_end": 72
          },
          {
            "file": "SKILL.md",
            "line_start": 72,
            "line_end": 84
          },
          {
            "file": "SKILL.md",
            "line_start": 84,
            "line_end": 88
          },
          {
            "file": "SKILL.md",
            "line_start": 88,
            "line_end": 100
          },
          {
            "file": "SKILL.md",
            "line_start": 100,
            "line_end": 106
          },
          {
            "file": "SKILL.md",
            "line_start": 106,
            "line_end": 107
          },
          {
            "file": "SKILL.md",
            "line_start": 107,
            "line_end": 108
          },
          {
            "file": "SKILL.md",
            "line_start": 108,
            "line_end": 109
          },
          {
            "file": "SKILL.md",
            "line_start": 109,
            "line_end": 110
          },
          {
            "file": "SKILL.md",
            "line_start": 110,
            "line_end": 111
          },
          {
            "file": "SKILL.md",
            "line_start": 111,
            "line_end": 112
          },
          {
            "file": "SKILL.md",
            "line_start": 112,
            "line_end": 113
          },
          {
            "file": "SKILL.md",
            "line_start": 113,
            "line_end": 114
          },
          {
            "file": "SKILL.md",
            "line_start": 114,
            "line_end": 115
          },
          {
            "file": "SKILL.md",
            "line_start": 115,
            "line_end": 116
          },
          {
            "file": "SKILL.md",
            "line_start": 116,
            "line_end": 122
          },
          {
            "file": "SKILL.md",
            "line_start": 122,
            "line_end": 123
          },
          {
            "file": "SKILL.md",
            "line_start": 123,
            "line_end": 126
          },
          {
            "file": "SKILL.md",
            "line_start": 126,
            "line_end": 140
          },
          {
            "file": "SKILL.md",
            "line_start": 140,
            "line_end": 141
          },
          {
            "file": "SKILL.md",
            "line_start": 141,
            "line_end": 142
          },
          {
            "file": "SKILL.md",
            "line_start": 142,
            "line_end": 143
          },
          {
            "file": "SKILL.md",
            "line_start": 143,
            "line_end": 144
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "network:references/auth-patterns.md:17:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/auth-patterns.md",
        "line_start": 17,
        "line_end": 17,
        "snippet": "f\"https://api.example.com/{endpoint}\","
      },
      {
        "id": "network:references/auth-patterns.md:41:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/auth-patterns.md",
        "line_start": 41,
        "line_end": 41,
        "snippet": "\"https://auth.example.com/token\","
      },
      {
        "id": "env_access:references/auth-patterns.md:10:python-environment-access",
        "category": "env_access",
        "severity": "low",
        "pattern": "Python environment access",
        "file": "references/auth-patterns.md",
        "line_start": 10,
        "line_end": 10,
        "snippet": "API_KEY = os.environ.get(\"MY_API_KEY\")"
      },
      {
        "id": "env_access:references/auth-patterns.md:10:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/auth-patterns.md",
        "line_start": 10,
        "line_end": 10,
        "snippet": "API_KEY = os.environ.get(\"MY_API_KEY\")"
      },
      {
        "id": "env_access:references/auth-patterns.md:11:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/auth-patterns.md",
        "line_start": 11,
        "line_end": 11,
        "snippet": "if not API_KEY:"
      },
      {
        "id": "env_access:references/auth-patterns.md:12:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/auth-patterns.md",
        "line_start": 12,
        "line_end": 12,
        "snippet": "raise ValueError(\"MY_API_KEY environment variable required\")"
      },
      {
        "id": "env_access:references/auth-patterns.md:18:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "references/auth-patterns.md",
        "line_start": 18,
        "line_end": 18,
        "snippet": "headers={\"Authorization\": f\"Bearer {API_KEY}\"}"
      },
      {
        "id": "blocker:references/resource-patterns.md:44:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/resource-patterns.md",
        "line_start": 44,
        "line_end": 44,
        "snippet": "item_id = uri.replace(\"item://\", \"\")"
      },
      {
        "id": "sensitive:references/state-patterns.md:10:sqlite-database-file",
        "category": "sensitive",
        "severity": "medium",
        "pattern": "SQLite database file",
        "file": "references/state-patterns.md",
        "line_start": 10,
        "line_end": 10,
        "snippet": "DB_PATH = Path.home() / \".my-mcp-server\" / \"state.db\""
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 52,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 52,
        "line_end": 56,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 56,
        "line_end": 66,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 66,
        "line_end": 72,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:72:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 72,
        "line_end": 84,
        "snippet": "```json"
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 84,
        "line_end": 88,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 88,
        "line_end": 100,
        "snippet": "```json"
      },
      {
        "id": "external_commands:SKILL.md:100:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 100,
        "line_end": 106,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 106,
        "line_end": 107,
        "snippet": "| Tool validation | Input sanitization with Pydantic | `./references/tool-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 107,
        "line_end": 108,
        "snippet": "| Error handling | Graceful failure responses | `./references/tool-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:108:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 108,
        "line_end": 109,
        "snippet": "| Multiple tools | CRUD-style tool registration | `./references/tool-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:109:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 109,
        "line_end": 110,
        "snippet": "| Static resources | Config/settings exposure | `./references/resource-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:110:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 110,
        "line_end": 111,
        "snippet": "| Dynamic resources | Database-backed resources | `./references/resource-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 111,
        "line_end": 112,
        "snippet": "| Environment auth | API key from env vars | `./references/auth-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:112:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 112,
        "line_end": 113,
        "snippet": "| OAuth tokens | Token refresh with TTL | `./references/auth-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:113:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 113,
        "line_end": 114,
        "snippet": "| SQLite cache | Persistent state storage | `./references/state-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 114,
        "line_end": 115,
        "snippet": "| In-memory cache | TTL-based caching | `./references/state-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:115:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 115,
        "line_end": 116,
        "snippet": "| Manual testing | Quick validation script | `./references/testing-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 116,
        "line_end": 122,
        "snippet": "| pytest async | Unit tests for tools | `./references/testing-patterns.md` |"
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 122,
        "line_end": 123,
        "snippet": "| Server not starting | Check `command` path, ensure dependencies installed |"
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 123,
        "line_end": 126,
        "snippet": "| Tool not appearing | Verify `list_tools()` returns valid schema |"
      },
      {
        "id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 126,
        "line_end": 140,
        "snippet": "| JSON parse errors | Ensure `call_tool` returns proper content structure |"
      },
      {
        "id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 140,
        "line_end": 141,
        "snippet": "- `./references/tool-patterns.md` - Validation, error handling, multi-tool registration"
      },
      {
        "id": "external_commands:SKILL.md:141:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 141,
        "line_end": 142,
        "snippet": "- `./references/resource-patterns.md` - Static and dynamic resource exposure"
      },
      {
        "id": "external_commands:SKILL.md:142:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 142,
        "line_end": 143,
        "snippet": "- `./references/auth-patterns.md` - Environment variables, OAuth token refresh"
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 143,
        "line_end": 144,
        "snippet": "- `./references/state-patterns.md` - SQLite persistence, in-memory caching"
      },
      {
        "id": "network:SKILL.md:130:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 130,
        "line_end": 130,
        "snippet": "- https://modelcontextprotocol.io - MCP specification"
      },
      {
        "id": "network:SKILL.md:131:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 131,
        "line_end": 131,
        "snippet": "- https://modelcontextprotocol.io/docs/concepts/tools - Tools reference"
      },
      {
        "id": "network:SKILL.md:132:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 132,
        "line_end": 132,
        "snippet": "- https://modelcontextprotocol.io/docs/concepts/resources - Resources reference"
      },
      {
        "id": "network:SKILL.md:133:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 133,
        "line_end": 133,
        "snippet": "- https://github.com/modelcontextprotocol/python-sdk - Python SDK"
      },
      {
        "id": "network:SKILL.md:134:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 134,
        "line_end": 134,
        "snippet": "- https://github.com/modelcontextprotocol/servers - Official MCP servers"
      },
      {
        "id": "env_access:SKILL.md:79:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 79,
        "line_end": 79,
        "snippet": "\"MY_API_KEY\": \"your-key-here\""
      },
      {
        "id": "env_access:SKILL.md:95:generic-api-secret-keys",
        "category": "env_access",
        "severity": "high",
        "pattern": "Generic API/secret keys",
        "file": "SKILL.md",
        "line_start": 95,
        "line_end": 95,
        "snippet": "\"MY_API_KEY\": \"your-key-here\""
      },
      {
        "id": "blocker:SKILL.md:123:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 123,
        "line_end": 123,
        "snippet": "| Tool not appearing | Verify `list_tools()` returns valid schema |"
      }
    ],
    "finding_verdicts": [
      {
        "id": "network:references/auth-patterns.md:17:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a documentation example using example.com as a placeholder API endpoint. It is not executed by the skill and does not define a hidden outbound destination."
      },
      {
        "id": "network:references/auth-patterns.md:41:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "This is a placeholder OAuth token URL in an authentication pattern. It is example documentation, not a live callback or concealed exfiltration endpoint."
      },
      {
        "id": "env_access:references/auth-patterns.md:10:python-environment-access",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The snippet reads a named environment variable in an authentication example. Reading a configured API key is expected here, and no secret value is embedded."
      },
      {
        "id": "env_access:references/auth-patterns.md:10:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.86,
        "reason": "MY_API_KEY is a placeholder variable name, not a literal credential. The context is standard environment-based authentication guidance."
      },
      {
        "id": "env_access:references/auth-patterns.md:11:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.87,
        "reason": "The line checks whether the placeholder API key variable exists. It does not reveal, store, or transmit a real credential."
      },
      {
        "id": "env_access:references/auth-patterns.md:12:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.87,
        "reason": "The error message names a required placeholder variable. It does not include a credential value or instruct secret disclosure."
      },
      {
        "id": "env_access:references/auth-patterns.md:18:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The bearer header uses a placeholder API key in an example request. The paired endpoint is example.com, so this is instructional rather than credential exfiltration."
      },
      {
        "id": "blocker:references/resource-patterns.md:44:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The code strips an item URI prefix to obtain a resource identifier. It does not inspect host details, enumerate files, or collect system information."
      },
      {
        "id": "sensitive:references/state-patterns.md:10:sqlite-database-file",
        "verdict": "false_positive",
        "confidence": 0.82,
        "reason": "This is a sample local SQLite path for an MCP state cache. It does not read an existing sensitive database or expose stored user data."
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The finding points to a Markdown Python code fence. It is not Ruby backtick execution or a shell command substitution."
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The finding points to a Markdown code fence delimiter. It is formatting text, not executable shell syntax."
      },
      {
        "id": "external_commands:SKILL.md:56:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The finding points to a Markdown project layout block. It is documentation formatting, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The finding points to a Markdown code fence delimiter. It does not execute a command or interpolate shell output."
      },
      {
        "id": "external_commands:SKILL.md:72:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line starts a JSON configuration example. The enclosed command field is a fixed MCP server launch example, not user-controlled execution by the skill."
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The finding points to a Markdown code fence delimiter. It is not Ruby backtick execution or shell execution."
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The line starts a JSON configuration example for uv. It is static setup documentation, not code that the skill executes."
      },
      {
        "id": "external_commands:SKILL.md:100:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The finding points to a Markdown code fence delimiter. It is not executable command syntax."
      },
      {
        "id": "external_commands:SKILL.md:106:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. They are inline Markdown, not shell command substitution."
      },
      {
        "id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. No command or interpreter is invoked."
      },
      {
        "id": "external_commands:SKILL.md:108:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. This is not external command execution."
      },
      {
        "id": "external_commands:SKILL.md:109:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. It is a reference link style, not shell syntax."
      },
      {
        "id": "external_commands:SKILL.md:110:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. It does not cause any command execution."
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. The context is a quick reference, not executable shell code."
      },
      {
        "id": "external_commands:SKILL.md:112:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. No shell command or Ruby backtick behavior is present."
      },
      {
        "id": "external_commands:SKILL.md:113:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. It only identifies another reference document."
      },
      {
        "id": "external_commands:SKILL.md:114:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. This is Markdown formatting, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:115:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. It is not executable code."
      },
      {
        "id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative documentation file path in a table. The table does not invoke any external process."
      },
      {
        "id": "external_commands:SKILL.md:122:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The inline code names a configuration field in troubleshooting text. It does not execute a command or use shell interpolation."
      },
      {
        "id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The inline code names the list_tools function in troubleshooting guidance. It is a documentation reference, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The inline code names the call_tool function in troubleshooting guidance. It is not Ruby backtick execution or a shell command."
      },
      {
        "id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative reference file path in a list. It is Markdown formatting, not executable shell syntax."
      },
      {
        "id": "external_commands:SKILL.md:141:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative reference file path in a list. No command is executed by the skill."
      },
      {
        "id": "external_commands:SKILL.md:142:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative reference file path in a list. It is not shell command substitution."
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The backticks mark a relative reference file path in a list. This is documentation formatting only."
      },
      {
        "id": "network:SKILL.md:130:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a public MCP specification link in the official documentation section. It is not an outbound request made by the skill."
      },
      {
        "id": "network:SKILL.md:131:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a public MCP tools documentation link. It is a reference URL, not hidden network behavior."
      },
      {
        "id": "network:SKILL.md:132:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a public MCP resources documentation link. The skill does not fetch it or send data to it."
      },
      {
        "id": "network:SKILL.md:133:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a public GitHub link to the MCP Python SDK. It is included as documentation, not as an executed network call."
      },
      {
        "id": "network:SKILL.md:134:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "This is a public GitHub link to official MCP server examples. It is a user-facing reference URL only."
      },
      {
        "id": "env_access:SKILL.md:79:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The value is the placeholder string your-key-here in a sample Claude Desktop config. It does not contain a real credential."
      },
      {
        "id": "env_access:SKILL.md:95:generic-api-secret-keys",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "The value is the placeholder string your-key-here in a sample uv configuration. It does not expose an actual API key."
      },
      {
        "id": "blocker:SKILL.md:123:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The line advises checking that list_tools returns a valid schema. It does not direct the model to gather system or environment information."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 6,
    "total_lines": 432,
    "audit_model": "codex",
    "audited_at": "2026-07-04T16:42:20.474Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Build MCP Server Patterns",
    "value_statement": "MCP integrations need correct tool, resource, auth, state, and test patterns. This skill provides focused examples for Claude Code, Codex, and Claude workflows.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "MCP",
      "Model Context Protocol",
      "MCP server",
      "tool handlers",
      "MCP resources",
      "OAuth patterns",
      "Python MCP"
    ],
    "actual_capabilities": [
      "Shows a basic Python MCP server with tool listing, tool calls, and stdio startup.",
      "Provides Claude Desktop configuration examples using Python and uv commands.",
      "Documents validation, error handling, and multiple tool registration patterns.",
      "Explains static resources and dynamic resource lookup patterns.",
      "Covers environment API keys, OAuth token refresh, SQLite state, and TTL caching.",
      "Includes manual test and pytest async testing examples for MCP tools."
    ],
    "limitations": [
      "Examples are illustrative and require adaptation before production use.",
      "It does not implement a complete production MCP server.",
      "It does not verify provider credentials or remote API behavior.",
      "It does not replace MCP documentation or a security review."
    ],
    "use_cases": [
      {
        "title": "Prototype an MCP Server",
        "description": "Create a starting structure for tools, handlers, and stdio startup.",
        "target_user": "Backend developer"
      },
      {
        "title": "Add Auth and State",
        "description": "Apply examples for API keys, token refresh, local state, and cache behavior.",
        "target_user": "Integration engineer"
      },
      {
        "title": "Test Tool Behavior",
        "description": "Use manual and async test patterns to check tool outputs and edge cases.",
        "target_user": "QA engineer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Plan a Simple Server",
        "scenario": "Beginner planning for a new MCP server.",
        "prompt": "Use mcp-patterns to plan a minimal Python MCP server for [task]. Include tool names, inputs, and startup approach."
      },
      {
        "title": "Design Tool Handlers",
        "scenario": "Intermediate design for validated tool calls.",
        "prompt": "Use mcp-patterns to design MCP tool handlers for [workflow]. Include validation rules, error handling, and expected responses."
      },
      {
        "title": "Add Resources and State",
        "scenario": "Intermediate expansion with resources and caching.",
        "prompt": "Use mcp-patterns to add resource exposure and state caching for [server]. Note what data should not be cached."
      },
      {
        "title": "Review Production Readiness",
        "scenario": "Advanced review before installation or release.",
        "prompt": "Use mcp-patterns to review an MCP server plan for auth, command configuration, testing, failure modes, and security gaps."
      }
    ],
    "output_examples": [
      {
        "input": "Plan a basic MCP server for searching internal documents.",
        "output": [
          "A tool list with search and fetch actions.",
          "Input validation boundaries for query text and result limits.",
          "A startup plan using a fixed local server command."
        ]
      },
      {
        "input": "Add authentication and caching to an MCP integration.",
        "output": [
          "Environment variable names for credentials.",
          "Token refresh behavior with expiry handling.",
          "Cache storage rules and data sensitivity notes."
        ]
      },
      {
        "input": "Create a test plan for MCP tool handlers.",
        "output": [
          "Manual checks for tool discovery and sample calls.",
          "Async test cases for expected results and empty results.",
          "Failure cases for invalid inputs and remote errors."
        ]
      }
    ],
    "best_practices": [
      "Validate every tool input before calling handlers or remote APIs.",
      "Use placeholders in examples and store real secrets outside source control.",
      "Test discovery, successful calls, empty results, and error responses."
    ],
    "anti_patterns": [
      "Do not copy placeholder API keys into committed configuration files.",
      "Do not expose resources that contain secrets or private user data.",
      "Do not install command configurations without checking paths and arguments."
    ],
    "faq": [
      {
        "question": "What does this skill help me build?",
        "answer": "It helps plan and implement MCP server patterns for tools, resources, authentication, state, and tests."
      },
      {
        "question": "Does it create a complete server automatically?",
        "answer": "No. It provides examples and patterns that you adapt to your project."
      },
      {
        "question": "Can I use it with Claude Code?",
        "answer": "Yes. The examples target Claude Code and common MCP server workflows."
      },
      {
        "question": "Can Codex use these patterns?",
        "answer": "Yes. Codex can use the same MCP design patterns when helping with implementation."
      },
      {
        "question": "Does it include authentication guidance?",
        "answer": "Yes. It covers environment API keys and OAuth token refresh patterns."
      },
      {
        "question": "What should I review before production use?",
        "answer": "Review command paths, secrets handling, resource exposure, cache contents, tests, and error handling."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "auth-patterns.md",
          "type": "file",
          "path": "references/auth-patterns.md",
          "lines": 51
        },
        {
          "name": "resource-patterns.md",
          "type": "file",
          "path": "references/resource-patterns.md",
          "lines": 49
        },
        {
          "name": "state-patterns.md",
          "type": "file",
          "path": "references/state-patterns.md",
          "lines": 58
        },
        {
          "name": "testing-patterns.md",
          "type": "file",
          "path": "references/testing-patterns.md",
          "lines": 40
        },
        {
          "name": "tool-patterns.md",
          "type": "file",
          "path": "references/tool-patterns.md",
          "lines": 89
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 145
    }
  ]
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall