Borrowing it
Nothing to install: this file belongs to plainday/manual-works-mcp. 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/plainday/manual-works-mcp/main/CLAUDE.mdgit clone --depth 1 https://github.com/plainday/manual-works-mcpWrote 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/plainday/manual-works-mcp/claude-md)<a href="https://agentmods.dev/instructions/plainday/manual-works-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/plainday/manual-works-mcp/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/plainday/manual-works-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/plainday/manual-works-mcp/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.00861 | $0.00861 |
| Opus 5.5 | $0.00344 | $0.00344 |
| Sonnet 5.5 | $0.00172 | $0.00172 |
| Haiku 4.5 | $0.00086 | $0.00086 |
Grade A, and why
manual-works-mcp 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.
How it starts
The opening of the file, as written. The whole thing — 84 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Project Overview
manual-works-mcp는 ManualWorks 문서 검색을 위한 MCP(Model Context Protocol) 서버입니다. ManualWorks에 검색 API가 없어서, 문서 목록/내용 API를 조합하여 키워드 검색 기능을 제공합니다. Apache 2.0 라이선스.
Technology Stack
- Language: Python 3.10+
- Protocol: MCP (Model Context Protocol)
- MCP SDK:
mcp[cli](FastMCP) - HTTP Client:
httpx(async) - Transport: streamable-http (기본
127.0.0.1:8000) - Build:
hatchling - Package Manager:
uv(권장) 또는pip
Project Structure
src/manual_works_mcp/
├── __init__.py
├── server.py # MCP 서버 진입점, search_documents tool 등록
└── api_client.py # ManualWorks REST API 클라이언트 (async httpx)
Key Components
api_client.py — ManualWorksClient
ManualWorks REST API 호출 클래스. URL 패턴: {base_url}/r/api/{api_uuid}?action={action}&...
get_documents()→DOC_LIST(응답:documents)get_document(doc_id)→DOC_GET(파라미터:docId, 응답:document)get_chapter_content(chapter_id)→DOC_CHAPTER_CONTENT(파라미터:chapterId, 응답:elements)get_chapter_headings(chapter_id)→DOC_CHAPTER_HEADING(파라미터:chapterId, 응답:headings)
server.py — MCP Server
search_documents(keyword: str) tool 1개 등록.
로깅:
- 통일 포맷:
YYYY-MM-DD HH:MM:SS LEVEL name message - uvicorn 기본
LOGGING_CONFIG를 패치하여 uvicorn 로그에도 동일 포맷 적용 KeyboardInterrupt처리로 Ctrl+C 시 정상 종료
검색 흐름:
DOC_LIST로 전체 문서 목록 조회- 각 문서에 대해
DOC_GET으로 장(chapter) 목록 조회 - PART > CHAPTER 재귀 구조 처리 (
_collect_chapters) - 각 장에 대해
DOC_CHAPTER_CONTENT로 내용 조회 - 문서 제목, 장 제목, 내용(content)에서 키워드 매칭 (대소문자 무시)
- 매칭 결과에 문서 링크, 장 링크, 요소 링크 포함하여 반환
Environment Variables
| 변수 | 설명 |
|---|---|
MANUALWORKS_BASE_URL |
ManualWorks 서버 URL (예: http://127.0.0.1:1975) |
MANUALWORKS_API_UUID |
API UUID (예: 5b969d63e97cfec7) |
MANUALWORKS_MCP_HOST |
MCP 서버 바인딩 호스트 (기본: 127.0.0.1) |
MANUALWORKS_MCP_PORT |
MCP 서버 포트 (기본: 8000) |
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 · 84 lines · 861 tokens per session scan A 5eefce03e80e
manual-works-mcp CLAUDE.md is an instructions file published in the GitHub repository plainday/manual-works-mcp (0 stars, last pushed 8mo ago), licensed Apache-2.0. It adds 861 tokens to every session, about $0.0034 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.
manual-works-mcp CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| manual-works-mcp CLAUDE.mdplainday/manual-works-mcp | Instructions file | 0 | 8mo ago | Apache-2.0 | A | 861 | 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 |