Bareun — Korean NLP & Spell/Grammar Checking

Bareun MCP 服务 — 韩语 NLP 与拼写／语法检查

바른(Bareun) 是一个韩语自然语言平台。这是它的 MCP（Model Context Protocol） 服务——它让任何兼容 MCP 的 AI 工具（Claude、Cursor、 VS Code、Claude Desktop 等）都能通过调用 Bareun 作为工具来执行韩语形态分析和 拼写／语法纠正。

大模型仍会遗漏韩语中细微的空格规则、助词搭配和易混词规则。将 Bareun 接入为 MCP 工具后，Agent 就能将分析和校对工作交给专用韩语引擎，再利用结果生成更准确的韩语内容。

• 托管端点： 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 的真实输出）：

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

每项修正都会以区块形式返回，因此 Agent 可以解释所做的修改，而不是悄悄重写句子：

原文	修正后	类别	规则
회의결과를	회의 결과를	SPACING	复合名词空格
보내주시기	보내 주시기	SPACING	辅助动词空格
바람니다.	바랍니다.	TYPO	拼写错误

形态分析 — analyze_syntax（format: compact）：

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

同形词义项 — analyze_syntax 搭配 with_sense: true（测试版）：在 배가 아프다 中的 배 会返回 senseNo: 1 及其词典释义——사람이나 동물의 몸에서 … 가슴과 엉덩이 사이의 부위（腹部，概率为 0.87），以及 Urimalsaem 词条 ID——因此 Agent 能知道它读到的是哪个 배。

---

工具

工具	功能	关键输入
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	按字母（音素级）槽位模式搜索 Urimalsaem 韩语词典（约 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 对象——词典词义编号、韩语释义、Urimalsaem 词条 ID，以及所选词义在该词候选词义中的概率。此功能默认关闭（会额外运行一次模型；省略该参数时，响应与此前逐字节相同），并且 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 密钥

---

快速开始

提示——全局注册。 大多数工具默认使用项目范围（服务仅在一个项目中可用）。若要在所有项目中使用 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": []
    }
  }
}

所有五个工具均为只读（readOnlyHint），因此将它们列入 autoApprove 是安全的，这样就不必确认每次调用。

ChatGPT — 开发者模式

ChatGPT 可直接连接 Streamable HTTP 服务，无需审核目录。 开启开发者模式（Settings → Apps & Connectors → Advanced），然后创建 一个连接器：

• URL： https://api.bareun.ai/mcp
• 身份验证： OAuth — Bareun 使用自己的 OAuth 2.1 (PKCE) 端点，因此 ChatGPT 会打开一个登录页面，供你粘贴 Bareun API 密钥。（ChatGPT 的连接器 对话框提供 OAuth 或无身份验证选项；如果你的版本也允许设置请求标头，那么 api-key 标头同样适用。）

ChatGPT 不同版本的菜单措辞和套餐可用性会有所变化 — 开发者模式是 账户级开关；在 Business/Enterprise 中，需要先由工作区所有者启用。

使用 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 License 发布。Bareun 引擎本身是 由 Baikal AI 运营的专有服务；访问权限受 bareun.ai 服务条款约束。