Clearon Content Archive MCP
Clearon Content Archive MCP
추가 전용 콘텐츠 기록, 검증된 게시 이력, 소셜 후속 처리, 검색에 적합한 메타데이터를 위한 MCP 서버입니다.
이 서버는 자체적으로 아무것도 게시하지 않으면서 출처(provenance)와 작업 흐름 상태를 보존하도록 설계되었습니다.
기능
슬러그(slug)별로 추가 전용 콘텐츠 이벤트를 저장합니다.
빠른 읽기를 위해 구체화된 스냅샷을 유지합니다.
검증된 WordPress 및 소셜 결과를 기록합니다.
이전 기록을 다시 쓰지 않고 소스 수정 사항을 추적합니다.
중복 검색, 인벤토리, 후속 처리 보고를 제공합니다.
이벤트 기록이 저장된 스냅샷과 정확히 일치하는지 검증합니다.
Related MCP server: What Brandon Thinks Chat MCP
하지 않는 일
WordPress나 소셜 플랫폼에 게시하지 않습니다.
publish로 표시된 페이로드를 실제 게시의 증거로 간주하지 않습니다.법적 또는 편집상 진위 여부를 판단하지 않습니다.
구성된 작업 공간 밖의 아티팩트 경로를 허용하지 않습니다.
요구 사항
Node.js
20이상stdio 서버를 실행할 수 있는 로컬 MCP 클라이언트
설치
cd tools/clearon-content-archive-mcp
npm install
npm test
npm run smokeMCP 클라이언트 설정
stdio 구성 예시:
{
"mcpServers": {
"clearon-content-archive": {
"command": "node",
"args": ["/absolute/path/to/clearon-content-archive-mcp/server.mjs"],
"env": {
"CLEARON_CONTENT_ARCHIVE_WORKSPACE": "/absolute/path/to/workspace"
}
}
}
}CLEARON_CONTENT_ARCHIVE_WORKSPACE를 사용하여 로컬 아티팩트 경로가 검증되는 기준 루트를 정의합니다. 아카이브 저장 위치는 CLEARON_CONTENT_ARCHIVE_ROOT로 재정의할 수 있습니다.
저장소
기본적으로 아카이브 데이터는 저장소 외부의 사용자 데이터 디렉터리에 저장됩니다.
macOS:
~/Library/Application Support/clearon-content-archive-mcp/content-archiveLinux:
${XDG_DATA_HOME:-~/.local/share}/clearon-content-archive-mcp/content-archiveWindows:
%APPDATA%\\clearon-content-archive-mcp\\content-archive
각 레코드는 records/<slug>/ 아래에 저장되며 다음을 보관합니다.
events.jsonlsnapshot.json
검증 및 복구
verify_archive_record는 읽기 전용입니다. 다시 구성된 이벤트 기록을 저장된 스냅샷과 비교하여 일치 여부를 보고합니다.
자동 복구는 새 이벤트를 추가하기 전에 부분적으로 수행된 이전 쓰기에서 복구해야 하는 변경 경로에만 사용됩니다.
패키지 감사 CLI는 다음과 같습니다.
npm run audit검증 실패를 조용히 건너뛰지 않고 명시적으로 보고합니다.
권장 워크플로
로컬 초안 패키지를 등록합니다.
검증된 게시 또는 업데이트 결과를 추가합니다.
차단 또는 건너뜀을 포함한 LinkedIn 및 X 결과를 추가합니다.
출처 수정 사항을 새 이벤트로 기록합니다.
관련 작업 초안을 작성하기 전에 중복 및 검색 도구를 사용합니다.
감사 중에 인벤토리 및 미완료 후속 처리 출력을 사용합니다.
마이그레이션, 수동 복구 또는 손상이 의심되는 경우 검증을 실행합니다.
도구
get_server_healthregister_content_packageget_content_recordsearch_content_archivefind_content_recordupdate_content_artifactsrecord_publicationrecord_social_resultrecord_source_correctionapprove_voice_examplecompare_payload_to_live_statefind_content_overlaplist_incomplete_follow_throughlist_update_candidatesgenerate_content_inventoryverify_archive_record
URL 처리
저장되는 URL은 http 또는 https를 사용해야 하며, URL에 포함된 자격 증명은 거부됩니다.
아카이브 기록은 추가 전용이므로 쿼리 문자열에 토큰이나 기타 비밀 정보가 포함된 민감한 URL을 기록하지 않도록 하세요.
개발
npm test
npm run smoke
npm run syntax
npm run auditAvailable Tools
16 toolsapprove_voice_exampleB
Explicitly mark an exact archived excerpt as an approved Clearon voice example; never infers approval.
Inputs: slug (required), excerpt (required), expected_revision (required), note, +1 more.
compare_payload_to_live_stateC
Compare a workspace-contained WordPress payload with a caller-supplied verified live-state response.
Inputs: slug (required), live_state (required), payload_path.
find_content_overlapB
Rank potentially overlapping archived content using disclosed lexical overlap; requires editorial review.
Inputs: slug (required), limit.
find_content_recordB
Find exact archive records by content slug, WordPress post ID, or recorded publication/social URL.
Inputs: url, slug, post_id.
generate_content_inventoryA
Generate a current structured inventory of archive, publication, social, topic, correction, and voice-example counts.
Inputs: no named parameters.
get_content_recordA
Read a content snapshot and, by default, its complete append-only event history.
Inputs: slug (required), include_events.
get_server_healthB
Report archive health, storage root, and non-publishing safety boundaries.
Inputs: no named parameters.
list_incomplete_follow_throughA
List records missing verified WordPress publication, featured-image verification, or completed LinkedIn/X outcomes.
Inputs: no named parameters.
list_update_candidatesA
List mechanically stale publications, post-publication source corrections, and image-verification gaps; does not make editorial recommendations.
Inputs: older_than_days.
record_publicationB
Record a verified WordPress outcome. This tool never publishes and does not infer live state from a payload.
Inputs: slug (required), status (required), expected_revision (required), url, +10 more.
record_social_resultA
Record a LinkedIn or X outcome, including published URLs, schedules, queues, or blockers. This tool never posts.
Inputs: slug (required), status (required), platform (required), expected_revision (required), +7 more.
record_source_correctionA
Append a provenance correction without rewriting the earlier archive history.
Inputs: slug (required), field (required), reason (required), previous_value (required), +4 more.
register_content_packageB
Create an append-only Clearon content record with local artifacts and editorial retrieval metadata.
Inputs: slug (required), title (required), content_type (required), topics, +6 more.
search_content_archiveC
Search archived titles, summaries, openings, topics, jurisdictions, and terminology.
Inputs: query, topic, jurisdiction.
update_content_artifactsC
Append a metadata or local-artifact update using optimistic revision control.
Inputs: slug (required), expected_revision (required), note, title, +7 more.
verify_archive_recordA
Replay an append-only event log and confirm whether it matches the stored snapshot without repairing it.
Inputs: slug (required), include_rebuilt_snapshot.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools target distinct resources and actions, such as searching, exact lookup, and registering content. The main ambiguity is between list_incomplete_follow_through and list_update_candidates, which both surface records needing verification or correction, but their descriptions largely clarify the intended focus.
All tool names use a consistent lower_snake_case verb_noun pattern, such as get_content_record, record_publication, and approve_voice_example. Even the longer compound names like compare_payload_to_live_state and list_incomplete_follow_through follow the same predictable action-first convention.
The server has 16 tools, which is slightly above the typical well-scoped range, but each tool appears to support a distinct archival lifecycle concern. The count is not excessive given the breadth of content, publication, social, correction, and voice-example workflows being covered.
The tool set covers the core content archive lifecycle: register, read, search, update, verify, and append publication/social/correction outcomes. Minor gaps exist, such as no explicit unpublish or approval-revocation tool, but the append-only design and existing verification tools make those acceptable omissions.
Related MCP Connectors
Preserve public web pages as signed, timestamped evidence packages, then verify them, compare versions and monitor pages for changes.
Issue & verify signed (ed25519), hash-chained, timestamped provenance receipts for agent actions.
Privacy-first document verification anchored to the public ledger.
Prove a web page or document existed on a date: public SHA-256 registry anchored in Bitcoin. Free.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables users to create frozen, auditable snapshots of selected Markdown or text-layer PDFs and perform read-only, verifiable local searches with SQLite FTS5/BM25, preserving source hashes, schemas, and page/line anchors.82Apache 2.0
- AlicenseAqualityCmaintenanceEnables privacy-aware, deterministic, read-only chat analysis through tools for briefs, aggregate interaction signals, evidence-aware claim audits, and canonical resource discovery.242MIT
- AlicenseBqualityCmaintenanceEnables deterministic RSS 2.0 feed publishing and lifecycle management, including immutable entry IDs, corrections, retractions, archiving, content-addressed media assets, and semantic search over active entries.16MIT
- AlicenseNot gradedqualityCmaintenanceEnables capturing web evidence, freezing content-addressed snapshots, and comparing research agents on the same sources with traceable access and quotations.1MIT