mcp-grammar-checker

LanguageTool의 문법 및 스타일 검사를 도구로 노출하는 작은 MCP 서버로, MCP 클라이언트(Claude Code, Claude Desktop 또는 기타 MCP 호환 호스트)가 텍스트의 문제를 직접 확인할 수 있게 해줍니다.

Why

AI 코딩 어시스턴트가 모델의 자체 판단에만 의존하지 않고 실제 도구 기반으로 문법/스타일을 검사할 수 있는 방법을 제공하기 위해, 그리고 Solution Architect AI 애플리케이션을 위해 MCP를 직접 실습하며 배우기 위해 만들었습니다.

Related MCP server: estonian-mcp

Process note

처음에는 수작업으로(튜토리얼을 따르지 않고 설치된 패키지를 직접 검사하여 공식 mcp SDK의 현재 API를 발견하면서) 직접 구축했습니다. 이후 Anthropic의 공식 mcp-server-dev:build-mcp-server 스킬의 가이드 프로세스에 따라 재구축했는데, 이 과정에서 배포 선택(로컬 stdio — 단일 사용자 개인 도구이지 배포용이 아님)은 확인되었지만 프레임워크는 변경되었습니다. Python 서버의 경우 mcp SDK에 번들된 고정된 FastMCP 1.0이 아니라 FastMCP 3.x(PyPI의 fastmcp 패키지, jlowin 작성)를 권장합니다. 이 저장소는 이제 그 두 번째 가이드 패스를 반영합니다.

Tool

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

공개 LanguageTool API를 사용하여 주어진 텍스트를 검사하고, 발견된 문제의 형식화된 목록(메시지, 제안된 대체어, 주변 컨텍스트) 또는 문제가 발견되지 않았음을 반환합니다.

Setup

Python 3.12+ 및 uv가 필요합니다.

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

Running standalone

uv run python server.py

서버는 stdio를 통해 통신하며 MCP 클라이언트에 의해 실행되도록 설계되었습니다. 대화형으로 실행되지 않습니다.

Using with Claude Code / Claude Desktop

MCP 구성에 추가하세요(예: .claude/settings.json 또는 Claude Desktop 구성 파일):

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

클라이언트를 다시 시작하면 check_grammar 도구를 사용할 수 있습니다.

Notes

• 공개 LanguageTool API(api.languagetool.org)를 사용하며, 이 API는 속도 제한이 있습니다. 더 많은 사용이 필요하면 LanguageTool을 자체 호스팅할 수 있습니다.

• language 매개변수를 통해 LanguageTool이 지원하는 모든 언어(예: en-US, de-DE, fr)를 지원합니다.