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

바른(Bareun) 是一个韩语自然语言平台。这是它的 MCP（模型上下文协议） 服务器——它让任何兼容 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

资源

快速开始

提示——全局注册。 大多数工具默认为项目范围（服务器仅在一个项目中可用）。要在所有项目中跨项目使用 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 服务条款约束。