Bareun — Korean NLP & Spell/Grammar Checking

Bareun MCP Server — 韓国語 NLP・スペル／文法チェック

바른(Bareun) は韓国語の自然言語プラットフォームです。これはその MCP（Model Context Protocol） サーバーです。MCP 互換の AI ツール（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 は公開されません）。同じエンドポイントはセルフホスト／オンプレミスのインストールでも 動作します。ホスト名を置き換えるだけです。

---

使用例

スペルと分かち書き — correct_grammar（https://api.bareun.ai/mcp からの実際の出力）：

入力	회의결과를 정리해서 내일까지 보내주시기 바람니다.
出力	회의 결과를 정리해서 내일까지 보내 주시기 바랍니다.

修正箇所はそれぞれブロックとして返されるため、エージェントは文を黙って書き換えるのではなく、修正内容を説明できます。

原文	修正後	カテゴリ	ルール
회의결과를	회의 결과를	SPACING	複合名詞の分かち書き
보내주시기	보내 주시기	SPACING	補助動詞の分かち書き
바람니다.	바랍니다.	TYPO	誤字

形態素解析 — analyze_syntax（format: compact）：

入力	나는 학교에 간다.
出力	나/NP 는/JX 학교/NNG 에/JKB 가/VV ㄴ다/EF ./SF

同形異義語の語義 — with_sense: true を指定した analyze_syntax（ベータ版）：배가 아프다 の 배 は、senseNo: 1 と辞書の定義（사람이나 동물의 몸에서 … 가슴과 엉덩이 사이의 부위、「腹」、確率 0.87）、さらにウリマルセムの項目 ID とともに返されるため、エージェントはどの 배 を読んでいるのか把握できます。

---

ツール

ツール	機能	主な入力
analyze_syntax	文を単語／形態素に分割し、品詞を付与します（形態素解析）。	text（必須）、auto_split_sentence、auto_spacing、auto_jointing、custom_dict_names、encoding、format（full|compact）、with_sense
analyze_syntax_raw	後処理なしで同じ解析を行います（複合名詞／動詞の分割、自動スペース挿入、カスタム辞書は適用されません）。モデルの生出力です。	text（必須）、auto_split_sentence、encoding、format、with_sense
search_dict	ウリマルセム韓国語辞書（約110万件）を、ジャモ（音素レベル）のスロットパターンで検索します。たとえば「語幹がㅎの終声で終わる動詞」や「-아지で終わる語」など、組み立てられたハングル音節では表現できない条件を指定できます。	pattern（必須）、anchor（word|prefix|suffix|contains）、pos、std_only、with_definition、limit、count_only
tokenize	文を単語（トークン）単位に分割します。	text（必須）、auto_spacing、encoding
correct_grammar	スペルとスペースを修正し、修正箇所のブロックを返します。	text（必須）、custom_dict_names、および9個のブール型修正オプション
list_pos_tags	Bareun が使用する47個の品詞タグ（コード・名称・クラス）を返します。	(なし)

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++）。

with_sense — 同形異義語の語義曖昧性解消（WSD、ベータ版）。 韓国語では、多くの 無関係な語が同じ綴りになります。배 は「お腹」、「船」、「梨」のいずれかを表します。analyze_syntax／analyze_syntax_raw で with_sense: true を設定すると、各内容形態素に sense オブジェクトが付与されます。これには、辞書の語義番号、韓国語の定義、ウリマルセムのエントリー ID、 およびその語の候補語義の中から選ばれた語義の確率が含まれます。デフォルトではオフです （モデルのパスが1回追加されます。省略した場合、レスポンスは従来とバイト単位で同一です）。 format=compact ではインラインで 배__002/NNG と表示されます。この機能はベータ版で、 Bareun 3.1.0 で正式に提供されます。

リソース

リソース URI	内容	認証
bareun://pos-tags	47個の品詞タグ（コード・名称・クラス）— list_pos_tags と同じデータ	API キー
bareun://server-info	サーバーメタデータ — 名前・バージョン・ビルド・有効なツール／リソース	API キー
bareun://custom-dicts	キーに登録されているカスタム辞書ドメインの名前	有効な API キー

---

クイックスタート

ヒント — グローバルに登録する。 ほとんどのツールはデフォルトでプロジェクトスコープです（サーバーは 1つのプロジェクトでのみ利用できます）。以下の手順でグローバル／ユーザースコープに登録すると、 すべてのプロジェクトで 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"
      ]
    }
  }
}

Cline — cline_mcp_settings.json

Cline で MCP Servers → Configure MCP Servers を開き、次を追加します。

{
  "mcpServers": {
    "bareun": {
      "type": "streamableHttp",
      "url": "https://api.bareun.ai/mcp",
      "headers": { "api-key": "YOUR_API_KEY" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

5つのツールはすべて読み取り専用（readOnlyHint）なので、毎回の呼び出しを確認しない設定にする場合は、 autoApprove に登録しても安全です。

ChatGPT — Developer Mode

ChatGPT は Streamable HTTP サーバーに直接接続するため、ディレクトリのレビューは不要です。 Developer mode（Settings → Apps & Connectors → Advanced）をオンにしてから、コネクターを作成します。

• URL: https://api.bareun.ai/mcp
• Authentication: OAuth — Bareun は独自の OAuth 2.1（PKCE）エンドポイントを提供しているため、ChatGPT は Bareun API キーを貼り付けるログインページを開きます。（ChatGPT のコネクター設定ダイアログでは OAuth または認証なしを選択できます。お使いのビルドでリクエストヘッダーも設定できる場合は、api-key ヘッダーでも同様に利用できます。）

メニューの表記やプランの提供状況は ChatGPT のリリースによって変わります。Developer mode はアカウント単位の設定で、Business／Enterprise では、まずワークスペースのオーナーが有効にする必要があります。

MCP Inspector でテストする

npx @modelcontextprotocol/inspector

Transport を 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 License のもとで公開されています。Bareun エンジン自体は Baikal AI が運営するプロプライエタリサービスであり、利用には bareun.ai の利用規約が適用されます。