What is SQMCPaL CLAUDE.md?

Project instructions for SQMCPaL, a read-only MCP server that lets an MCP client query Azure Database for PostgreSQL Flexible Servers using an existing Azure login.

Understanding the server’s Python, MCP, PostgreSQL, and Azure setup; running it; and performing its tests, lint checks, and type checks.

They document the project’s purpose, setup, tests, and checks so contributors can run and maintain it consistently.

How ChingEnLin/SQMCPaL configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to ChingEnLin/SQMCPaL. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/ChingEnLin/SQMCPaL/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/ChingEnLin/SQMCPaL

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/chingenlin/sqmcpal/claude-md.svg)](https://agentmods.dev/instructions/chingenlin/sqmcpal/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/chingenlin/sqmcpal/claude-md"><img src="https://agentmods.dev/badge/instructions/chingenlin/sqmcpal/claude-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 1,018 This file is loaded in full into every session.

When invoked 1,018 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.01018	$0.01018
Opus 5	$0.00509	$0.00509
Sonnet 5	$0.00204	$0.00204
Haiku 4.5	$0.00102	$0.00102

Measured 6d ago against content hash 378c4748fafd, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

SQMCPaL CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 39 lines

How it starts

The opening of the file, as written. The whole thing — 39 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

Purpose

Read-only MCP server exposing your Azure Database for PostgreSQL Flexible Servers to any MCP client, authenticating via your existing az login session — for individual local dev use. SQL sibling of QueryMCPal (Cosmos Mongo API) and BlobMCPal (Azure Storage).

Tech stack

Python >=3.11 (Docker image and ruff/mypy target 3.12), packaged with hatchling.
MCP: mcp[cli]>=2.0 using the MCPServer decorator API over stdio.
Data: psycopg (v3) against PostgreSQL Flexible Server.
Azure: azure-identity (DefaultAzureCredential) + raw ARM via requests for server discovery.
cachetools for TTL caching of ARM responses.

Run / build / test

Run from source: uvx sqmcpal (or sqmcpal console script after pip install -e .).
Dev setup: uv venv --python 3.12 && uv pip install -e ".[dev]" && pre-commit install.
Self-check: python test_sqmcpal.py — asserts the read-only SQL guard. The only test; the DB layer is verified by connecting to a real server.
Lint/type checks: pre-commit run --all-files, i.e. ruff check, ruff format --check, mypy --strict.
Smoke test: pipe an MCP initialize JSON-RPC message into sqmcpal and expect serverInfo.name = "sqmcpal" (see README).
Build Docker image: docker build --platform linux/arm64 -t sqmcpal:dev . (use linux/amd64 on Intel/Linux).

Architecture

src/sqmcpal/:

server.py — MCP entrypoint (main). One @app.tool() function per tool; schemas are derived from type hints and docstrings, so the docstring is the tool description the model reads. Owns the result cap and the single in-process session.
azure_service.py — DefaultAzureCredential auth, ARM-based flexible-server discovery across subscriptions, and the Entra token used as the DB password. Login role is read from the token's own upn claim.
pg_service.py — read-only PostgreSQL ops (catalog, describe, query, count, distinct); caches connections per (host, database, user) and reconnects when the token nears expiry. Owns assert_read_only.
context.py — SessionContext dataclass holding active server/database/schema.

Read the full file on GitHub · 39 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

6d ago First seen · 39 lines · 1,018 tokens per session scan A 378c4748fafd

Subscribe to this mod's changes

SQMCPaL CLAUDE.md is an instructions file published in the GitHub repository ChingEnLin/SQMCPaL (0 stars, last pushed 1mo ago), licensed MIT. It adds 1,018 tokens to every session, about $0.0051 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

SQMCPaL: Instructions file for Claude Code