SpellChecker

A fast, multilingual Model Context Protocol (MCP) server that provides spell-checking capabilities to Large Language Models. This server enables LLMs to check spelling in text, files, and entire projects with syntax-aware parsing for code files.

- Multi-language support: 15+ languages including English, Spanish, French, German, Portuguese, Italian, Dutch, Polish, Russian, Ukrainian, Swedish, Danish, and Norwegian
- Syntax-aware checking: Intelligently checks only comments, strings, and documentation in code files
- File and folder scanning: Check individual files or entire project directories
- Modular language activation: Enable only the languages you need
- Fast spell checking: Powered by nspell for efficient processing
- Custom dictionary management: Add words to personal dictionaries
- Smart code parsing: Understands HTML, JavaScript, TypeScript, Python, and more
- MCP-compliant: Works with any MCP-compatible client

git clone https://github.com/yourusername/spellchecker-mcp-server.git cd spellchecker-mcp-server

The post-install script will automatically download the required dictionary files.

Add the server to your Claude Desktop configuration file:

macOS:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "spellchecker": { "command": "node", "args": ["/path/to/spellchecker-mcp-server/dist/index.js"], "env": { "SPELLCHECKER_LANGUAGES": "en-US,es,fr" } } } }

You can configure which languages to enable in three ways:
-

Environment variable(recommended for Claude Desktop):

SPELLCHECKER_LANGUAGES="en-US,es,fr" node dist/index.js

SPELLCHECKER_CONFIG="/path/to/spellchecker.config.json" node dist/index.js

Edit the default insrc/config.tsbefore building

The server runs on stdio and can be integrated with any MCP-compatible client:

node /path/to/spellchecker-mcp-server/dist/index.js

Checks text for spelling errors and returns misspellings with suggestions.

- text(required): The text to check
- language(optional): Language code (default: "en-US")
- includeLineNumbers(optional): Include line/column positions (default: false)

{ "text": "This is a tset of the speling checker", "language": "en-US", "includeLineNumbers": true }

Checks if a single word is spelled correctly.

- word(required): The word to check
- language(optional): Language code (default: "en-US")

- word(required): The word to get suggestions for
- language(optional): Language code (default: "en-US")
- limit(optional): Maximum suggestions to return (default: 5)

Adds a word to the personal dictionary for a language.

- word(required): The word to add
- language(optional): Language code (default: "en-US")

Lists all available languages for spell checking.

Checks spelling in a single file with syntax-aware parsing.

- filePath(required): Path to the file to check
- language(optional): Language code (default: "en-US")
- syntaxAware(optional): Enable syntax-aware parsing (default: true)

{ "filePath": "/path/to/app.tsx", "language": "en-US", "syntaxAware": true }

Checks spelling in all files within a folder.

- folderPath(required): Path to the folder to check
- language(optional): Language code (default: "en-US")
- recursive(optional): Check subfolders (default: true)
- fileTypes(optional): Array of file extensions to check
- syntaxAware(optional): Enable syntax-aware parsing (default: true)

{ "folderPath": "/path/to/project", "language": "en-US", "recursive": true, "fileTypes": [".js", ".tsx", ".md"], "syntaxAware": true }

The server supports 15+ languages. Enable only what you need:

- en-US- English (United States)
- en-GB- English (United Kingdom)
- es- Spanish
- fr- French
- de- German
- pt- Portuguese
- pt-BR- Portuguese (Brazil)
- it- Italian
- nl- Dutch
- pl- Polish
- ru- Russian
- uk- Ukrainian
- sv- Swedish
- da- Danish
- nb- Norwegian Bokmål

WhensyntaxAwareis enabled, the spell checker intelligently parses:

- Comments: Single-line and multi-line comments in all major languages
- String literals: Only checks strings that look like human-readable text
- JSX/TSX content: Text between JSX tags
- Documentation: Docstrings, JSDoc comments, etc.
- Markdown: Ignores code blocks and inline code
- HTML/XML: Checks text content and comments

- Variable names and identifiers
- Programming keywords
- URLs and file paths
- Hex colors and numbers
- Code within backticks in Markdown

- Node.js >= 16.0.0
- Yarn package manager

# Install dependencies yarn install # Run in development mode yarn dev # Build for production yarn build # Type check yarn typecheck

# Show available commands just # Fresh install just fresh # Run development server just dev # Update dictionaries just dictionaries

- @modelcontextprotocol/sdk: MCP protocol implementation
- nspell: Hunspell-compatible spell checker
- glob: File pattern matching for directory scanning
- TypeScript: Type-safe development
- Dictionary files: From the wooorm/dictionaries project

{ "languages": ["en-US", "es", "fr"], "defaultLanguage": "en-US", "scanOptions": { "syntaxAware": true, "recursive": true, "fileTypes": [ ".txt", ".md", ".mdx", ".js", ".jsx", ".ts", ".tsx", ".py", ".java", ".go" ], "ignorePaths": [ "node_modules", ".git", "dist", "build" ] } }

Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (git checkout -b feature/AmazingFeature)
- Commit your changes (git commit -m 'Add some AmazingFeature')
- Push to the branch (git push origin feature/AmazingFeature)
- Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

- Dictionary files fromwooorm/dictionaries
- Built on theModel Context Protocol

yarn run postinstall # or just dictionaries

Connect any AI assistant to Syncro: manage tickets, invoices, customers, assets, and more.