Hangul-MCP

# Hangul-MCP (한국어 유틸리티) Hangul-MCP is a Korean utility service based on MCP (Model Chaining Protocol). It provides functions such as Korean spelling check and Romanization using the [kospell](https://github.com/Alfex4936/kospell) library. <p align="center"> <img src="https://github.com/user-attachments/assets/b95384dd-b046-4be5-9abe-92e767e46464" width="80%"/> <br/> <img src="https://github.com/user-attachments/assets/36a4ddd5-e4a4-4262-a909-15c971165c37" width="80%"/> <br/> <img src="https://github.com/user-attachments/assets/952f82f4-c3a2-445f-bc6d-ac7f383b646b" width="80%"/> </p> ## Features KoGrammar provides the following features: 1. **Spell check**: Checks the spelling of Korean sentences and suggests corrections for errors. 2. **Character count**: Calculates the number of characters and eojeol in Korean text. 3. **Resume review**: A function specialized for resume writing, providing character limit verification and spelling feedback together. 4. **Romanization**: Converts Korean text according to the National Institute of Korean Language's Romanization notation. ## MCP Tool List KoGrammar provides the following MCP tools: 1. `count_korean_letters`: Calculates the number of characters and eojeol in Korean text. 2. `check_korean_grammar`: Checks the spelling of Korean sentences and provides correction suggestions. 3. `resume_review`: A review function specialized for resumes, providing integrated character count verification and spell checking. 4. `romanize_korean`: Converts Korean text into Roman characters according to the National Institute of Korean Language notation. ## Installation ### Binary Download We provide binaries that can be executed in Windows or Linux environments: - Windows: `kogrammar.exe` - Linux: `kogrammar-linux-amd64` ### Source Code Build To build directly from the source code, follow these steps: 1. Install Go 1.24 or higher 2. Clone the repository ``` git clone https://github.com/Alfex4936/Hangul-MCP cd Hangul-MCP ``` 3. Install dependencies ``` go mod download ``` 4. Build ``` go build -o kogrammar ``` ## Usage KoGrammar can be integrated with other applications via the MCP protocol. You can register the server in `settings.json` or a similar environment configuration file as follows. ```json { "mcpServers": { "kogrammar-server": { "command": "path/to/your/kogrammar.exe", "args": [], "env": {} } } } ``` ## Credits - (주)나라인포테크의 맞춤법 검사기 - [kospell](https://github.com/Alfex4936/kospell) - Korean spelling check library - [mcp-go](https://github.com/mark3labs/mcp-go) - Model Chaining Protocol Go implementation