chrischinchilla/vale-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

26 stars 8 forks 质量 88 趋势 31MIT

Repository Install

一款模型上下文协议（MCP）服务器，将Vale散文线条整合到AI编码助手如Claude Desktop、Cursor及其他兼容MCP的工具中。

概览

一款模型上下文协议（MCP）服务器，将Vale散文线条整合到AI编码助手如Claude Desktop、Cursor及其他兼容MCP的工具中。该MCP服务器为AI助手提供使用Vale强大打印引擎检查文件样式和语法问题的能力。它自动发现Vale配置文件，并提供格式化、可操作的写作质量反馈。 - ✅ 文件衬里处理：检查任何文本文件是否有Vale样式问题- 🔍 智能配置发现：自动找到.vale。

概述（AI 翻译）

一款模型上下文协议（MCP）服务器，将Vale散文线条整合到AI编码助手如Claude Desktop、Cursor及其他兼容MCP的工具中。

概述

该MCP服务器为AI助手提供使用Vale强大打印引擎检查文件样式和语法问题的能力。它自动发现Vale配置文件，并提供格式化、可操作的写作质量反馈。

快速安装

特色

✅ 文件填充：检查任何文本文件是否有Vale的样式问题
🔍 智能配置发现：利用Vale原生向上搜索自动查找.vale.ini文件
🎯 配置优先级：支持VALE_CONFIG_PATH环境变量以实现显式配置
📊 丰富格式化：返回带有表情符号和严重程度分组的降价格式结果
🛡️ 优雅降级：在未安装Vale时提供有用的安装指导
🐛 调试模式：可选的调试日志，用于故障排除
📦 样式同步：使用 vale_sync 工具下载 Vale 风格包

系统需求

Node.js： 版本22及以上
Vale： 版本3.0或更高版本

安装

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

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

在 GitHub 查看完整 README

安装

npx vale-mcp@latest

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "vale": {
      "command": "npx",
      "args": ["vale-mcp@latest"]
    }
  }
}