Bareun MCP Server — корейское NLP и проверка орфографии/грамматики

바른 (Bareun) — это корейская NLP-платформа естественного языка. Это её MCP (Model Context Protocol) сервер: он позволяет любому MCP-совместимому ИИ-инструменту (Claude, Cursor, VS Code, Claude Desktop, …) выполнять корейский морфологический анализ и исправление орфографии/грамматики, вызывая Bareun как инструмент.

Большие языковые модели по-прежнему упускают тонкости корейского языка — пробелы, согласование служебных частиц и правила легко спутанных слов. Подключите Bareun как инструмент MCP, и ваш агент сможет передать анализ и вычитку выделенному корейскому движку, а затем использовать результат для более точного вывода на корейском.

• Размещённая конечная точка: https://api.bareun.ai/mcp

• Транспорт: Streamable HTTP (JSON-RPC 2.0) — без SSE, без лишнего порта, без установки

• Аутентификация: API-ключ (заголовок api-key или Authorization: Bearer <key>)

• Получите API-ключ: https://bareun.ai

Конечная точка /mcp доступна в сборке Bareun с включённой проверкой орфографии (сборка только с морфологическим анализом не открывает /mcp). Та же точка работает и на локальных/on-premises установках — просто замените хост.

Инструменты

Параметры correct_grammar (все булевы, по умолчанию выключены): 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 управляет единицами смещения морфем: utf32 (по умолчанию, кодовые точки — соответствует Python), utf16 (JS/Java), utf8 (байты — Go/C++).

Related MCP server: mcp-korean-spell

Ресурсы

Краткое начало

Совет — регистрируйте глобально. Большинство инструментов по умолчанию работают в области проекта (сервер доступен только в одном проекте). Чтобы использовать Bareun во всех ваших проектах, зарегистрируйте его на уровне глобально / пользователя, как показано ниже.

Claude Code

# -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"

Опустите -s user для области локального проекта. Проверьте командой claude mcp get bareun.

Cursor

Глобально:~/.cursor/mcp.json · Проект: <project>/.cursor/mcp.json

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

vs code

Глобально: откройте MCP: Open User Configuration · Проект: <project>/.vscode/mcp.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 подключает удалённые серверы с аутентификацией по заголовкам через mcp-remote (требуется Node.js):

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

Тестирование с помощью MCP Inspector

npx @modelcontextprotocol/inspector

Установите параметр Транспорт как Streamable HTTP, параметр URL как https://api.bareun.ai/mcp и добавьте заголовок api-key: YOUR_API_KEY.

Пример

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

Ссылки

• Сервис: https://bareun.ai

• Документация: https://bareun.ai/docs

• Руководство по MCP: https://bareun.ai/docs/howtouse/mcp

• API-ключи и использование: https://bareun.ai/docs/howtouse/cloud-api

Лицензия

Содержимое этого репозитория (документация, манифесты реестра, примеры) выпущено под лицензией MIT. Сам движок Bareun — проприетарный сервис, управляемый Baikal AI; доступ регулируется условиями обслуживания на bareun.ai.