Borrowing it
Nothing to install: this file belongs to Ahngbeom/mysql-mcp-server. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/Ahngbeom/mysql-mcp-server/main/CLAUDE.mdgit clone --depth 1 https://github.com/Ahngbeom/mysql-mcp-serverWrote 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.
[](https://agentmods.dev/instructions/ahngbeom/mysql-mcp-server/claude-md)<a href="https://agentmods.dev/instructions/ahngbeom/mysql-mcp-server/claude-md"><img src="https://agentmods.dev/badge/instructions/ahngbeom/mysql-mcp-server/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/ahngbeom/mysql-mcp-server/claude-md"><img src="https://agentmods.dev/badge/instructions/ahngbeom/mysql-mcp-server/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.00584 | $0.00584 |
| Opus 5.5 | $0.00234 | $0.00234 |
| Sonnet 5.5 | $0.00117 | $0.00117 |
| Haiku 4.5 | $0.00058 | $0.00058 |
Grade A, and why
mysql-mcp-server 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 2mo 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.
What it actually says
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
프로젝트 개요
MySQL 데이터베이스에 접근하기 위한 읽기 전용 MCP(Model Context Protocol) 서버. NPM 패키지로 배포됨 (@ahngbeom/mysql-mcp-server).
빌드 및 실행
npm run build # TypeScript → JavaScript (dist/)
npm run dev # 개발 모드 (tsx로 직접 실행)
npm start # 빌드된 서버 실행
로컬 테스트
# 환경변수 설정 후 개발 모드로 실행
MYSQL_HOST=localhost MYSQL_PORT=3306 MYSQL_USER=root MYSQL_PASS=password MYSQL_DB=testdb npm run dev
MCP 서버는 stdio 통신을 사용하므로 직접 테스트하려면 JSON-RPC 메시지를 stdin으로 전송해야 함.
아키텍처
단일 파일 구조 (src/index.ts):
┌─────────────────────────────────────────────────────────┐
│ MCP Server (@modelcontextprotocol/sdk) │
│ ├── Tool Handlers (6개 도구) │
│ │ └── query, list_tables, describe_table, │
│ │ show_indexes, show_create_table, explain │
│ └── Resource Handlers (테이블별 스키마/샘플 데이터) │
├─────────────────────────────────────────────────────────┤
│ Connection Pool (mysql2/promise, 최대 5 연결) │
└─────────────────────────────────────────────────────────┘
쿼리 보안
중요: src/index.ts:160-177에서 읽기 전용 검증 수행
const allowedPrefixes = ["select", "show", "describe", "explain"];
const isReadOnly = allowedPrefixes.some(prefix => trimmedSql.startsWith(prefix));
- 허용:
SELECT,SHOW,DESCRIBE,EXPLAIN - 차단:
INSERT,UPDATE,DELETE,DROP,CREATE,ALTER등
수정 시 보안 우회가 발생하지 않도록 주의 (예: 주석, 서브쿼리 등으로 우회 시도 가능성 검토).
환경 변수
| 변수 | 기본값 | 설명 |
|---|---|---|
MYSQL_HOST |
localhost | MySQL 호스트 |
MYSQL_PORT |
3306 | MySQL 포트 |
MYSQL_USER |
root | 사용자 |
MYSQL_PASS |
(없음) | 비밀번호 |
MYSQL_DB |
mysql | 데이터베이스 |
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.
- 2mo ago First seen · 65 lines · 584 tokens per session scan A f86c15c719ba
mysql-mcp-server CLAUDE.md is an instructions file published in the GitHub repository Ahngbeom/mysql-mcp-server (0 stars, last pushed 10mo ago), licensed MIT. It adds 584 tokens to every session, about $0.0023 per session on Opus 5.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.
mysql-mcp-server CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| mysql-mcp-server CLAUDE.mdAhngbeom/mysql-mcp-server | Instructions file | 0 | 10mo ago | MIT | A | 584 | Claude Code |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 144k | today | MIT | A | 8,130 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 5,685 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 150k | today | MIT | A | 4,680 | Codex, OpenCode |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 283k | today | MIT | A | 4,342 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 3,153 | GitHub Copilot |