Bareun MCP 서버 — 한국어 NLP 및 맞춤법/문법 검사

바른(Bareun) 은 한국어 자연어 플랫폼입니다. 이것은 MCP(Model Context Protocol) 서버로, MCP 호환 AI 도구(Claude, Cursor, VS Code, Claude Desktop 등)가 바른을 도구로 호출하여 한국어 형태소 분석과 맞춤법/문법 교정을 수행할 수 있게 해줍니다.

대규모 언어 모델은 여전히 한국어의 미묘한 띄어쓰기, 조사 일치, 혼동어 규칙을 놓치곤 합니다. 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

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 라이선스 하에 배포됩니다. Bareun 엔진 자체는 Baikal AI가 운영하는 독점 서비스이며, 접근은 bareun.ai 서비스 약관에 따릅니다.