hangulport

Name: hangulport
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords科研与教育01 周前更新

代码仓库

关于 hangulport

hangulport 是面向托管 Bareun 韩语 NLP 服务的命令行客户端和 stdio MCP 服务，提供形态分析、词典搜索、分词及拼写和空格纠正，并将调用转发至上游 API。

主要功能

01带词性的形态分析
02原始形态模型输出
03Urimalsaem 词典搜索
04句子分词
05拼写和空格纠正
06获取上游词性标签

适用场景

01分析韩语文本和词形
02按韩文字母模式查找词条
03将韩语句子拆分为词单元
04纠正拼写和空格

MCP 相关

stdio MCP 服务将 Bareun NLP 操作作为工具提供，并将调用转发至托管服务。使用时需要 Bareun API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-hangulport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/hangulport"
      ]
    }
  }
}

启动命令npx -y @reneturcios/hangulport

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/hangulport0.1.0stdio

ocighcr.io/cloudcorprecords/hangulport:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
text	string	是	要分析的韩语文本。
format	enum	否	输出格式：full 或 compact。full \| compact
encoding	enum	否	分析所用的文本编码：utf32、utf16 或 utf8。utf32 \| utf16 \| utf8
with_sense	boolean	否	为 true 时，在结果中包含词义信息。
auto_spacing	boolean	否	为 true 时，在分析前自动应用空格纠正。
auto_jointing	boolean	否	为 true 时，在分析前自动合并分开的韩文字母。
custom_dict_names	array	否	分析时要应用的自定义词典名称。
auto_split_sentence	boolean	否	为 true 时，在分析前自动将文本拆分为句子。

详细介绍

hangulport

hangulport 是托管式 Bareun 韩语 NLP 服务的客户端。它提供带词性标注的形态分析、原始形态模型输出、按韩文字母槽位模式搜索 Urimalsaem 词典、句子分词、拼写和空格纠正，以及服务的词性标签列表。一个二进制文件同时提供命令行界面和 stdio MCP 服务；两者都会将每次调用转发到托管端点。

需要 API 密钥。将 BAREUN_API_KEY 设置为你的 Bareun 密钥；该密钥只会作为 api-key 请求头发送到端点，不会发送到其他地方。除非 BAREUN_MCP_URL 覆盖端点，否则调用会发送到 https://api.bareun.ai/mcp。如果缺少密钥，调用会失败并提示 BAREUN_API_KEY 错误——不会在本地编造结果。list_pos_tags 背后的 47 个词性标签由上游提供；此处没有硬编码。

安装

npx @reneturcios/hangulport tokenize "안녕하세요"

或者运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/hangulport

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。两种方式都需要在环境中设置 BAREUN_API_KEY（对于 Docker，请添加 -e BAREUN_API_KEY=...）。

CLI

hangulport analyze_syntax "안녕하세요" --auto-spacing --encoding utf8 --format compact
hangulport analyze_syntax_raw "안녕하세요" --with-sense
hangulport search_dict "ㄱㅏ*" --anchor prefix --limit 5 --with-definition
hangulport tokenize "문장을 나눕니다" --auto-spacing
hangulport correct_grammar "띄어쓰기연습" --enable-sentence-check
hangulport list_pos_tags

hangulport --version

每个子命令都以其调用的 MCP 工具命名。第一个参数是必需的文本（或词典模式）；其余标志与工具的可选输入一一对应。布尔标志不接受值：传入标志即设为 true，省略则不会转发任何内容——此客户端不会自行注入默认值。--custom-dict-names 接受以逗号分隔的列表。命令会输出上游结果文本。退出代码：成功时为 0，调用失败（包括缺少密钥或上游错误）时为 1，用法错误时为 2。

MCP 服务

一个二进制文件提供这两种接口。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/hangulport mcp

MCP 客户端配置：

{
  "mcpServers": {
    "hangulport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/hangulport", "mcp"],
      "env": { "BAREUN_API_KEY": "your-key" }
    }
  }
}

若要将服务指向其他兼容 Bareun 的主机，请在客户端针对此服务的 env 中添加 BAREUN_MCP_URL。

工具

工具	输入	返回内容
`analyze_syntax`	`text`（必需）；可选 `auto_split_sentence`、`auto_spacing`、`auto_jointing`、`custom_dict_names`、`encoding`（`utf32`/`utf16`/`utf8`）、`format`（`full`/`compact`）、`with_sense`	带词性标注的形态分析。
`analyze_syntax_raw`	`text`（必需）；可选 `auto_split_sentence`、`encoding`、`format`、`with_sense`	原始形态模型输出，不进行后处理。
`search_dict`	`pattern`（必需）；可选 `anchor`（`word`/`prefix`/`suffix`/`contains`）、`pos`、`std_only`、`with_definition`、`limit`、`count_only`	与韩文字母槽位模式匹配的 Urimalsaem 词典条目。
`tokenize`	`text`（必需）；可选 `auto_spacing`、`encoding`	将句子拆分为词单元。
`correct_grammar`	`text`（必需）；可选 `custom_dict_names` 和九个布尔纠错选项（`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`）	拼写／空格纠正结果块。
`list_pos_tags`	（无）	上游提供的 47 个 Bareun 词性标签。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx