Claude Desktop, Cursor 및 기타 MCP 호환 도구와 같은 AI 코딩 조수로 Vale prose linting을 통합하는 모델 Context Protocol (MCP) 서버.

개요

이 MCP 서버는 Vale의 강력한 linting 엔진을 사용하여 스타일과 문법 문제에 대한 파일을 확인할 수있는 능력을 갖춘 AI 조수를 제공합니다. Vale 구성 파일을 자동으로 발견하고 쓰기 품질에 대한 포맷, 액션 피드백을 제공합니다.

빠른 설치

특징

• ✅ 파일 linting: Vale 스타일 문제에 대한 모든 텍스트 파일을 확인
• ܧ Smart configuration discovery: 자동적으로 Vale의 기본 위쪽 검색을 사용하여 .vale.ini 파일을 찾습니다.
• 구성 우선순위: VALE_CONFIG_PATH 환경 변수를 명시한 설정
• Rich Rich formatting : 이모티콘과 severity 그룹화로 Markdown-formatted 결과를 반환합니다.
• Val️ Graceful degradation : Vale가 설치되지 않을 때 유용한 설치 안내 제공
• ▫ 디버그 모드 : 문제 해결을위한 옵션 디버그 로깅
• ☸ 스타일 동기화 : 다운로드 Vale 스타일 패키지 vale_sync 도구

시스템 요구 사항

• **Node.js: ** 버전 22 이상 -Vale: 버전 3.0 이상

설치

Vale MCP Server

A Model Context Protocol (MCP) server that integrates Vale prose linting into AI coding assistants like Claude Desktop, Cursor, and other MCP-compatible tools.

Overview

This MCP server provides AI assistants with the ability to check files for style and grammar issues using Vale’s powerful linting engine. It automatically discovers Vale configuration files and provides formatted, actionable feedback about writing quality.

Quick install

Features

• ✅ File linting: Check any text file for style issues with Vale
• 🔍 Smart configuration discovery: Automatically finds .vale.ini files using Vale’s native upward search
• 🎯 Configuration priority: Supports VALE_CONFIG_PATH environment variable for explicit configuration
• 📊 Rich formatting: Returns markdown-formatted results with emojis and severity grouping
• 🛡️ Graceful degradation: Provides helpful installation guidance when Vale isn’t installed
• 🐛 Debug mode: Optional debug logging for troubleshooting
• 📦 Style sync: Download Vale style packages with vale_sync tool

System requirements

• Node.js: Version 22 or higher
• Vale: Version 3.0 or higher

Installation

Using npx (no install required)

You can run Vale MCP directly using npx without installing it globally:

npx vale-mcp@latest

This is the recommended approach for most users and is what the quick install badges above use.

Global install via npm

Install the vale-mcp package globally to create a system-wide vale-cli command:

npm i @iflow-mcp/chrischinchilla-vale-mcp

To uninstall:

npm uninstall -g vale-mcp

Build from source

# Clone or navigate to the project directory
cd Vale-MCP

# Install dependencies
npm install

# Build the TypeScript project
npm run build

# Install globally (creates a system-wide vale-cli command)
npm run install:global