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 のオプション（すべてブール型、デフォルトはオフ）： 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

リソース

クイックスタート

ヒント — グローバルに登録する。 ほとんどのツールはデフォルトで プロジェクト スコープです（サーバーは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"
      ]
    }
  }
}

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の利用規約が適用されます。