# Bareun — Korean NLP & Spell/Grammar Checking [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/gih2yun/bareun-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bareun-korean-nlp-spell-grammar-checking

## Description
Korean NLP MCP server: morphological analysis, tokenization, spell & grammar checking (Bareun)

## Tools
Capabilities this server exposes over MCP:

- **analyze_syntax** — Splits a sentence into words/morphemes and tags parts of speech (morphological analysis).
- **tokenize** — Splits a sentence into word (token) units.
- **correct_grammar** — Corrects spelling/spacing and returns correction blocks.
- **list_pos_tags** — Returns the 47 part-of-speech tags Bareun uses (code · name · class).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "grammar-checking": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"]
  }
}
```

## Documentation & README

# Bareun MCP Server — Korean NLP & Spell/Grammar Checking

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

> **바른(Bareun)** is a Korean natural-language platform. This is its **MCP (Model
> Context Protocol)** server — it lets any MCP-compatible AI tool (Claude, Cursor,
> VS Code, Claude Desktop, …) perform **Korean morphological analysis** and
> **spell/grammar correction** by calling Bareun as a tool.

Large language models still miss the subtle spacing, particle agreement, and
confusable-word rules of Korean. Plug Bareun in as an MCP tool and your agent can
hand off analysis and proofreading to a dedicated Korean engine, then use the
result to produce more accurate Korean output.

- **Hosted endpoint:** `https://api.bareun.ai/mcp`
- **Transport:** Streamable HTTP (JSON-RPC 2.0) — no SSE, no extra port, no install
- **Auth:** API key (`api-key` header or `Authorization: Bearer <key>`)
- **Get an API key:** https://bareun.ai

> The `/mcp` endpoint is available on the **spell-checker–included** build of Bareun
> (the morphological-analysis-only build does not expose `/mcp`). The same endpoint
> works on self-hosted/on-prem installs — just swap the host.

---

## Tools

| Tool | What it does | Key inputs |
|---|---|---|
| `analyze_syntax` | Splits a sentence into words/morphemes and tags parts of speech (morphological analysis). | `text` (required), `auto_split_sentence`, `auto_spacing`, `auto_jointing`, `custom_dict_names`, `encoding`, `format` (`full`\|`compact`) |
| `tokenize` | Splits a sentence into word (token) units. | `text` (required), `auto_spacing`, `encoding` |
| `correct_grammar` | Corrects spelling/spacing and returns correction blocks. | `text` (required), `custom_dict_names`, + 9 boolean correction options |
| `list_pos_tags` | Returns the 47 part-of-speech tags Bareun uses (code · name · class). | _(none)_ |

**`correct_grammar` options** (all boolean, default off): `treat_as_title`,
`disable_split_sentence`, `disable_caret_spacing`, `disable_vx_spacing`,
`enable_limited_punctuation`, `disable_confusion`, `enable_cleanup_whitespace`,
`disable_typo_correction`, `enable_sentence_check`.

**`encoding`** controls the unit for morpheme offsets: `utf32` (default, code points
— matches Python), `utf16` (JS/Java), `utf8` (bytes — Go/C++).

## Resources

| Resource URI | Contents | Auth |
|---|---|---|
| `bareun://pos-tags` | The 47 POS tags (code · name · class) — same data as `list_pos_tags` | API key |
| `bareun://server-info` | Server metadata — name · version · build · active tools/resources | API key |
| `bareun://custom-dicts` | Names of custom-dictionary domains registered for the key | **valid** API key |

---

## Quick start

> **Tip — register globally.** Most tools default to *project* scope (the server is
> only available in one project). To use Bareun across **all** your projects, register
> it at **global / user** scope as shown below.

### Claude Code

```bash
# -s user → global: available in every project
claude mcp add -s user --transport http bareun https://api.bareun.ai/mcp \
  --header "api-key: YOUR_API_KEY"
```

Omit `-s user` for project-local scope. Check with `claude mcp get bareun`.

### Cursor

Global: `~/.cursor/mcp.json` · Project: `<project>/.cursor/mcp.json`

```json
{
  "mcpServers": {
    "bareun": {
      "url": "https://api.bareun.ai/mcp",
      "headers": { "api-key": "YOUR_API_KEY" }
    }
  }
}
```

### VS Code

Global: run **MCP: Open User Configuration** · Project: `<project>/.vscode/mcp.json`

```json
{
  "servers": {
    "bareun": {
      "type": "http",
      "url": "https://api.bareun.ai/mcp",
      "headers": { "api-key": "YOUR_API_KEY" }
    }
  }
}
```

### Claude Desktop — `claude_desktop_config.json`

Claude Desktop bridges header-authenticated remote servers via `mcp-remote`
(Node.js required):

```json
{
  "mcpServers": {
    "bareun": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.bareun.ai/mcp",
        "--header", "api-key: YOUR_API_KEY"
      ]
    }
  }
}
```

### Test with MCP Inspector

```bash
npx @modelcontextprotocol/inspector
```

Set **Transport** to `Streamable HTTP`, **URL** to `https://api.bareun.ai/mcp`, and
add header `api-key: YOUR_API_KEY`.

---

## Example

```jsonc
// tools/call → analyze_syntax  (format: compact)
{ "text": "나는 학교에 간다.", "format": "compact" }
// → "나/NP 는/JX 학교/NNG 에/JKB 가/VV ㄴ다/EF ./SF"
```

## Links

- **Service:** https://bareun.ai
- **Docs:** https://bareun.ai/docs
- **MCP guide:** https://bareun.ai/docs/howtouse/mcp
- **API keys & usage:** https://bareun.ai/docs/howtouse/cloud-api

## License

The contents of this repository (documentation, registry manifests, examples) are
released under the [MIT License](./LICENSE). The Bareun engine itself is a
proprietary service operated by Baikal AI; access is governed by the bareun.ai
terms of service.