content-qa-mcp

편집 콘텐츠 QA를 위한 MCP(Model Context Protocol) 서버입니다. Claude에 기사를 지정하면 모든 발견 사항에 수정 사항이 첨부된 발견 보고서를 얻을 수 있습니다. 따라서 보고서는 단지 정확한 것에 그치지 않고 실제로 사용할 수 있습니다.

이 발견-수정 계약은 테스트 스위트에 의해 강제됩니다. 실행 가능한 수정 사항 없이 발견 사항을 내보내는 검사는 스위트를 실패시킵니다.

기능

네 가지 도구, 하나의 프롬프트, API 키 없음. 모든 것이 로컬에서 실행됩니다.

또한 전체 보고서를 구동하고 모델이 발견 사항을 완화하거나 지어내지 않고 편집 판정을 내리도록 요청하는 qa_review 프롬프트가 있습니다.

모든 발견 사항은 하나의 객체입니다:

{
  "check": "seo-onpage",
  "severity": "high",
  "excerpt": null,
  "finding": "No meta description.",
  "fix": "Add a 120-155 character meta description that states the article's payoff and includes the keyword once."
}

전체 실행 예시는 samples/sample-report.md에서 확인하세요. 의도적으로 손상된 픽스처 기사에 대한 22개의 발견 사항이 있으며, npm run sample로 재생성할 수 있습니다.

Related MCP server: pangram-editorial

Claude Code에 설치 및 등록

git clone https://github.com/Alvi-808/content-qa-mcp.git
cd content-qa-mcp
npm install
npm test        # 14 tests, includes a real MCP client/server handshake

등록(Claude Code CLI):

claude mcp add content-qa -- node /absolute/path/to/content-qa-mcp/src/server.js

작동 확인됨:

content-qa: C:\Program Files\nodejs\node.exe C:\...\content-qa-mcp\src\server.js - √ Connected

그런 다음 Claude Code 세션에서: "이 기사에 대해 qa_full_report 실행" 또는 qa_review 프롬프트를 사용하세요.

claude mcp remove content-qa로 제거합니다.

Windows 참고 사항(대부분의 튜토리얼이 건너뛰는 부분)

Windows에서는 stdio MCP 서버를 node.exe의 절대 경로와 스크립트로 등록하세요:

claude mcp add content-qa -- "C:\Program Files\nodejs\node.exe" "C:\path\to\content-qa-mcp\src\server.js"

npx 또는 .cmd 셰임을 통한 등록은 Windows에서 자주 연결에 실패합니다. 생성된 프로세스가 stdio를 올바르게 연결하지 못하기 때문이며, 실패는 조용히 발생합니다. 절대 node.exe 경로와 스크립트 경로를 사용하면 항상 작동합니다. 이 저장소의 종단 간 테스트도 동일한 패턴(process.execPath)을 사용합니다.

설계 노트

• 검사는 src/checks/의 순수 함수입니다. MCP 없이도 가져올 수 있습니다. 서버는 이들 위의 얇은 프로토콜 계층이므로 동일한 검사를 CI, git 훅 또는 파이프라인에서 실행할 수 있습니다.

• SEO 검사는 의도적으로 범위가 제한됩니다. 잘 구성된 CMS 기사 출력(WordPress, Ghost, 정적 사이트 생성기)을 정규식 추출로 파싱합니다. 일반 HTML 파서가 아니며 악의적인 마크업을 견디려고 시도하지 않습니다. 경계를 명명하는 것이 경계가 없다고 가장하는 것보다 낫습니다.

• 일반 텍스트 입력은 SEO 검사를 건너뜁니다. 가짜 "태그 누락" 발견 사항을 보고하는 대신입니다.

• 상투적 표현 목록은 문자열이 아닌 클래스를 금지합니다. 각 항목은 패턴이므로 클리셰의 한 단어 변형도 잡아냅니다.

존재 이유

이것은 유료 편집 QA 작업 뒤에 있는 작업 방법을 에이전트가 호출할 수 있는 도구로 패키징한 것입니다. 여기에 담긴 규칙은 다음과 같습니다. 무엇이 잘못되었는지 말하면서 다음에 무엇을 해야 하는지 말하지 않는 QA 보고서는 단지 작업을 다른 사람의 책상으로 옮길 뿐입니다. 발견 사항은 수정 사항과 함께 제공되거나 제공되지 않습니다.

라이선스

MIT