CompText MCP
The CompText MCP Server provides deterministic, read-only workspace inspection and context packaging tools for a Rust/CompText project environment, without network access or external dependencies.
comptext_status– Retrieve the current status of CompText, Rust, Cargo, Git, and the overall workspace.comptext_pack_context– Generate a deterministic context pack with stable file ordering and SHA-256 hashes (configurable byte limit, default 250,000 bytes).comptext_rust_audit– Run safe, read-only Rust checks includingcargo check, optional Clippy linting, and test compilation (without executing tests).comptext_replay_digest– Produce a deterministic replay/evidence digest of the current workspace state (configurable byte limit, default 250,000 bytes).comptext_contract_check– Verify local safety contracts for OpenCode usage.comptext_github_pack– Prepare a local GitHub summary pack without making any network calls.comptext_hf_export_pack– Generate Hugging Face Space/Card export text locally, without any upload or token usage.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CompText MCP pack context for current project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
comptext-mcp
comptext-mcp is the planned MCP contract layer for exposing deterministic
local ctxt --json results to MCP clients.
Phase 0 is documentation-only. This repository baseline does not implement an MCP server, package runtime, provider integration, token passthrough, proposal application, network access, external-agent invocation, or general shell access. Pre-existing runtime and package files may be present in the repository, but they are outside Phase 0 scope and are not treated as release-ready behavior by this documentation baseline.
Core principle:
Models are providers. Context is the product.
Architecture Position
ctxtis the deterministic source of truth.ctxtowns behavior, schemas, validation, and deterministic context.comptext-mcpmust not invent behavior.comptext-mcpis a future adapter only.Future MCP tools must map one-to-one to stable local
ctxt --jsoncommands.Runtime artifacts and proposal artifacts are untrusted evidence, not workspace truth.
Related MCP server: densely
Phase 0 Scope
Phase 0 creates the documentation and contract baseline only:
PROJEKT.mdREADME.md.gitignoreSECURITY.mddocs/ARCHITECTURE.mddocs/CONTRACTS.mddocs/ROADMAP.md
No runtime code, package scaffolding, server implementation, generated reports, hooks, plugins, dependencies, provider calls, proposal application, or general shell access are part of Phase 0.
Review Tool Policy
@github, @codex-security, and @openai-developers may be used only as
review and context tools for Phase 0 documentation. They do not grant
permission to create runtime code, call providers, enable network behavior,
create server implementation, add token passthrough, create hooks or plugins,
invoke external agents, apply proposals, or write git history.
Subagents, if used, are limited to deterministic review and planning over Phase 0 docs, security boundaries, tool mappings, and consistency.
Trusted Future Command Surface
Future MCP tools may only wrap these stable local commands:
ctxt --json self report
ctxt --json schema
ctxt --json capabilities
ctxt --json proposals list
ctxt --json proposals inspect latest --max-bytes 12000
ctxt --json proposals inspect --id latest --max-bytes 12000
ctxt --json proposals validate latest
ctxt --json proposals validate --id latest
ctxt --json validate --run
ctxt --json agent discover
ctxt --json runs list
ctxt --json runs read latest --max-bytes 12000Unsupported ctxt commands are not part of the Phase 0 MCP contract.
Documentation
Available Tools
7 toolscomptext_contract_checkC
Check local safety contracts for OpenCode usage.
Inputs: no named parameters. Returns: object
comptext_github_packA
Prepare a local GitHub summary pack without network calls.
Inputs: no named parameters. Returns: object
comptext_hf_export_packA
Return Hugging Face Space/Card export text without upload or token usage.
Inputs: no named parameters. Returns: object
comptext_pack_contextC
Create a deterministic context pack with stable file order and sha256 hashes.
Inputs: max_bytes. Returns: object
comptext_replay_digestC
Create a deterministic replay/evidence digest for the current workspace.
Inputs: max_bytes. Returns: object
comptext_rust_auditC
Run safe read-only Rust checks.
Inputs: check, clippy, tests_no_run. Returns: object
comptext_statusB
Return CompText, Rust, Cargo, Git, and workspace status.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: contract checking, GitHub packaging, Hugging Face export, context packing, replay digest, Rust audit, and status. There is no overlap or ambiguity.
All tools follow a consistent 'comptext_' prefix followed by descriptive snake_case names (e.g., comptext_contract_check, comptext_status). The pattern is uniform and predictable.
With 7 tools, the count is well within the ideal range (3-15). Each tool serves a clear function without excess or deficiency for the server's apparent scope.
The tools cover core workflows: contract checks, exports, context packing, digests, audits, and status. Minor gaps might exist (e.g., no tool for clearing or resetting state), but the set is largely complete for typical usage.
Maintenance
Related MCP Connectors
Turn a GitHub repo or docs site into agent-ready context: pack it or search it, over MCP.
A paid remote MCP for OpenAI Codex context compressor, built to return verdicts, receipts, usage log
Free OpenAI-compatible inference with signed provenance receipts and 3 focused MCP tools.
Deterministic MCP utilities, validation, evidence verification, and x402 commerce on Base.
Related MCP Servers
- AlicenseBqualityDmaintenanceA local, evidence-driven MCP runtime and control plane for open-source maintainers that provides workspace-bounded tools including controlled file operations, command execution, validation primitives, durable execution records, and human review workflows via stdio and Streamable HTTP transports.33MIT
- AlicenseNot gradedqualityDmaintenanceLossless context compression for LLMs, packing text into 2x-8x fewer tokens with byte-exact reconstruction. Provides MCP tools to compress files/text and expand exact slices, verified by sha256.54 PyPI8MIT
- AlicenseAqualityBmaintenanceZero-dependency stdio bridge to Moltline Studio's fleet of 14 hosted MCP servers covering code review, time operations, data transforms, business ops, education, research, outreach and more. Free tier requires no registration; premium tools unlock with a license. Independently audited, MCPize Verified A.10MIT
- AlicenseAqualityBmaintenanceTurn any folder or Git repo into safe, token-efficient context for LLMs, AI chats, and coding agents like Claude Code, Codex, and Cursor — local-first GUI, TUI, CLI, and a read-only MCP server with Live Context, agent journal, Smart Ignore, secret/PII redaction, Git scopes, and code compression. Windows, macOS, Linux.841Apache 2.0