Bareun MCP Server — Procesamiento de NLP coreano y corrección ortográfica/gramatical

바른(Bareun) es una plataforma coreana de lenguaje natural. Este es su servidor MCP (Model Context Protocol) — permite que cualquier herramienta de IA compatible con MCP (Claude, Cursor, VS Code, Claude Desktop, …) realice análisis morfológico del coreano y corrección ortográfica/gramatical llamando a Bareun como herramienta.

Los grandes modelos de lenguaje aún no captan las sutiles reglas de espaciado, concordancia de partículas y palabras confundibles del coreano. Conecta Bareun como herramienta MCP y tu agente podrá delegar el análisis y la corrección a un motor coreano dedicado, y luego usar el resultado para producir texto coreano más preciso.

• Endpoint alojado: https://api.bareun.ai/mcp

• Transporte: Streamable HTTP (JSON-RPC 2.0) — sin SSE, sin puerto adicional, sin instalación

• Autenticación: clave de API (cabecera api-key o Authorization: Bearer <key>)

• Obtén una clave de API: https://bareun.ai

El endpoint /mcp está disponible en la compilación de Bareun que incluye el corrector ortográfico (la compilación de solo análisis morfológico no expone /mcp). El mismo endpoint funciona en instalaciones autoalojadas/on-prem — solo cambia el host.

Herramientas

Opciones de correct_grammar (todas booleanas, desactivadas por defecto): 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 controla la unidad para los desplazamientos de morfemas: utf32 (predeterminado, puntos de código — coincide con Python), utf16 (JS/Java), utf8 (bytes — Go/C++).

Related MCP server: mcp-korean-spell

Recursos

Inicio rápido

Consejo — regístralo globalmente. La mayoría de las herramientas usan por defecto el ámbito de proyecto (el servidor solo está disponible en un proyecto). Para usar Bareun en todos tus proyectos, regístralo en el ámbito global / de usuario como se muestra a continuación.

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"

Omita -s user para el ámbito local del proyecto. Verifica con claude mcp get bareun.

Cursor

Global: ~/.cursor/mcp.json · Proyecto: <proyecto>/.cursor/mcp.json

{
  "mcpServers": {
    "bareun": {
      "url": "https://api.bareun.ai/mcp",
      "headers": { "api-key": "YOUR_API_KEY" }
    }
  }
}

VS Code

Global: ejecuta MCP: Open User Configuration · Proyecto: <proyecto>/.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 conecta servidores remotos autenticados por cabecera mediante mcp-remote (requiere Node.js):

{
  "mcpServers": {
    "bareun": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.bareun.ai/mcp",
        "--header", "api-key: YOUR_API_KEY"
      ]
    }
  }
}

Prueba con MCP Inspector

npx @modelcontextprotocol/inspector

Configura Transport en Streamable HTTP, URL en https://api.bareun.ai/mcp, y añade la cabecera api-key: YOUR_API_KEY.

Ejemplo

// tools/call → analyze_syntax  (format: compact)
{ "text": "나는 학교에 간다.", "format": "compact" }
// → "나/NP 는/JX 학교/NNG 에/JKB 가/VV ㄴ다/EF ./SF"

Enlaces

• Servicio: https://bareun.ai

• Documentación: https://bareun.ai/docs

• Guía de MCP: https://bareun.ai/docs/howtouse/mcp

• Claves de API y uso: https://bareun.ai/docs/howtouse/cloud-api

Licencia

El contenido de este repositorio (documentación, manifiestos de registro, ejemplos) se publica bajo la Licencia MIT. El motor Bareun en sí es un servicio propietario operado por Baikal AI; el acceso se rige por los términos de servicio de bareun.ai.