convez.ai
MCP Server
nozomi-koborinai

@contextlint/mcp-server

nozomi-koborinai/contextlint

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server for contextlint

Instalação

$npx convez-ai nozomi-koborinai/contextlint

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
47
Forks
3
Acompanhando
1
Saúde
57%
Último commit
há 5 dias
Versão
v1.1.1
Issues abertas
4
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

contextlint

npm version cli downloads mcp-server downloads lsp-server downloads CI License: Apache 2.0

🌐 日本語 | 中文 | 한국어

A rule-based linter for structured Markdown documents. Catch broken references, duplicate IDs, missing sections, and structural issues — deterministically, in seconds, CI-friendly.

📚 Full reference and guides: https://contextlint.dev

Why contextlint?

In AI-driven workflows like SDD (Spec Driven Development), Markdown documents form a dependency graph: requirements reference IDs, design docs link back to specs, ADRs cross-reference each other. When that graph silently breaks — a deleted requirement, a mistyped ID, a missing section — the consequence shows up only at read time.

contextlint provides deterministic, static validation for structured Markdown. No AI, no cost, CI-friendly.

contextlint focuses on content semantics and cross-file integrity. For Markdown syntax, formatting, and style, use markdownlint alongside contextlint — they complement each other well.

Quick Start

AI-assisted (recommended) — for Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, and any Agent Skills-compatible client. Requires GitHub CLI v2.90+:

gh skill install nozomi-koborinai/contextlint contextlint-init

Then ask your agent to "set up contextlint". The skill detects your repo layout, infers rules, installs the CLI, and writes contextlint.config.json for you.

Manual setup:

npm install -D @contextlint/cli
npx contextlint init
npx contextlint

Sample output:

docs/requirements.md
  line 3   warning  Empty cell in column "Status"  TBL-002

docs/design.md
  line 12  error    Link target "./api.md" does not exist  REF-001

1 error, 1 warning in 2 files

Rules

contextlint ships 21 rules across 7 categories:

PrefixCategoryWhat it validatesCount
TBLTableRequired columns, empty cells, allowed values, patterns, cross-column constraints, cross-file ID uniqueness6
SECSectionExistence and order of section headings2
STRStructureProject-level file existence1
REFReferenceLinks, anchors, cross-file ID references, stability consistency, zone dependencies, image references6
CHKChecklistChecklist completion status1
CTXContextPlaceholder detection, term consistency2
GRPGraphTraceability chains, circular references, orphan documents3

See Rules for the full per-rule reference.

Learn more

For commands beyond lint (init, impact, slice, graph, compile, --watch), run npx contextlint --help or browse the docs:

TopicLink
Get Startedhttps://contextlint.dev/docs/get-started/
Configuration referencehttps://contextlint.dev/docs/configuration/
Rule reference (all 21)https://contextlint.dev/docs/rules/
CLI commands and flagshttps://contextlint.dev/docs/integrations/cli/
Editor integration (LSP)https://contextlint.dev/docs/integrations/editors/
AI agents (MCP, Agent Skills)https://contextlint.dev/docs/integrations/ai-agents/
CI/CD integrationhttps://contextlint.dev/docs/integrations/ci-cd/
Recipes (ADR / SDD / monorepo)https://contextlint.dev/docs/recipes/
Programmatic Graph APIhttps://contextlint.dev/docs/graph-api/

Packages

PackageDescription
@contextlint/coreRule engine and Markdown parser
@contextlint/cliCLI entry point (contextlint command)
@contextlint/mcp-serverMCP server for AI tool integration
@contextlint/lsp-serverLanguage Server Protocol implementation
contextlint-vscodeVS Code / Cursor extension — install the VSIX from GitHub Releases until Marketplace publishing lands

Resources

License

Apache 2.0

Ver o original no GitHub

Relacionados