Skip to main content
Glama

mcp-grammar-checker

A small MCP server that exposes LanguageTool's grammar and style checking as a tool, so an MCP client (Claude Code, Claude Desktop, or any other MCP-compatible host) can check text for issues directly.

Why

Built to give an AI coding assistant a real, tool-backed way to check grammar/style — rather than relying only on the model's own judgment — while learning MCP hands-on for a Solution Architect AI application.

Related MCP server: estonian-mcp

Process note

First built by hand (directly against the official mcp SDK, discovering its current API by inspecting the installed package rather than following a tutorial). Later rebuilt against Anthropic's official mcp-server-dev:build-mcp-server skill's guided process, which confirmed the deployment choice (local stdio — this is a single-user personal tool, not something meant for distribution) but changed the framework: it recommends FastMCP 3.x (the fastmcp package on PyPI, by jlowin) for Python servers, not the frozen FastMCP 1.0 bundled inside the mcp SDK. This repo now reflects that second, guided pass.

Tool

check_grammar(text: str, language: str = "de-DE") -> str

Checks the given text using the public LanguageTool API and returns a formatted list of issues found (message, suggested replacements, surrounding context), or a confirmation that no issues were found.

Setup

Requires Python 3.12+ and uv.

git clone <this-repo>
cd mcp-grammar-checker
uv sync

Running standalone

uv run python server.py

The server communicates over stdio and expects to be launched by an MCP client, not run interactively.

Using with Claude Code / Claude Desktop

Add to your MCP config (e.g. .claude/settings.json or the Claude Desktop config file):

{
  "mcpServers": {
    "grammar-checker": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/mcp-grammar-checker", "python", "server.py"]
    }
  }
}

Restart the client, and the check_grammar tool will be available.

Notes

  • Uses the public LanguageTool API (api.languagetool.org), which is rate-limited. For heavier use, LanguageTool can be self-hosted.

  • Supports any language LanguageTool supports (e.g. en-US, de-DE, fr) via the language parameter.

Available Tools

1 tool
check_grammarB

Check text for grammar, spelling, and style issues using LanguageTool.

Inputs: text (required), language. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only a single tool, there is no possibility of ambiguity or misselection. The purpose is clearly singular and distinct.

    Naming Consistency5/5

    There is only one tool, so the naming is trivially consistent. The verb-noun pattern ('check_grammar') is clear and follows a predictable convention.

    Tool Count3/5

    A single tool feels thin for a server, though the scope is narrow (grammar checking). It is borderline per the calibration, likely sufficient for its stated purpose but minimal.

    Completeness5/5

    The tool covers grammar, spelling, and style checking, which appears to be the entire domain. There are no obvious missing operations for a grammar-checking service.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      An MCP server that integrates EstNLTK to provide Estonian language tools (morphology, spell-check, synonyms, etc.) for AI agents, enabling correct Estonian text processing and generation.
      28
      28
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server offering text analysis tools for writing improvement, including spellcheck, readability, keyword analysis, passive voice detection, and AI-generated content detection.
      11
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A professional MCP server for analyzing content against the official Microsoft Writing Style Guide, enabling style, grammar, terminology, and accessibility checks via AI tools like VS Code and GitHub Copilot.
      1
      -