Ko Stdict MCP

所有左字典mcp

《标准国语大词典》官方“下载词典”下载了JSON转储，并将其正规化为SQLite 后面使用MCP工具查询的Deno服务器。

特点

• 无需国家语言院Open API密钥即可工作
• 首次启动时下载官方的JSON转储并初始化SQLite
• 之后再使用本地ZIP缓存和规范化数据库
• 以标题为中心的搜索
• 查询时只能选择所需字段
• 基于Deno的stdio MCP服务器

要求

• Deno 2.0或更高版本

安装

deno install

执行

deno task dev

只准备初始数据：

deno task init

要强制接收并重新配置新转储，请：

deno task refresh

MCP客户端设置示例

{
  "mcpServers": {
    "ko-stdict": {
      "command": "deno",
      "args": [
        "run",
        "-A",
        "jsr:@hongminhee/ko-stdict-mcp"
      ]
    }
  }
}

本地结帐条件示例：

{
  "mcpServers": {
    "ko-stdict": {
      "command": "deno",
      "args": [
        "run",
        "-A",
        "/absolute/path/to/ko-stdict-mcp/main.ts"
      ]
    }
  }
}

数据位置

默认路径：

• Linux/macOS： ${XDG_DATA_HOME:-$HOME/.local/share}/ko-stdict-mcp

可更改为环境变量：

• KO_STDICT_DATA_DIR

交付工具

• search_entries：搜索表控制exact/prefix/contains
• get_entry: target_code 查看基础详细信息
• dictionary_status：查看本地数据状态
• refresh_dictionary：重新获得正式转储并刷新DB

选择字段示例

默认响应字段：

• target_code
• word
• hanja
• sup_no
• pos
• definition

例如，如果您只想要标题和释义：

{
  "query": "나무",
  "fields": ["word", "definition"]
}

开发

deno task check
deno task test

部署

GitHub Actions workflow在版本标签被推后尝试JSR publish。 标签名称为 deno.json的 version必须完全相同 v 前缀为 不允许。

示例：

git tag 0.1.0
git push origin 0.1.0

第一次，在JSR软件包设置中，将此存储库的trusted publishing 需要连接。

许可证

AGPL 3.0 或更高版本。

源数据

该项目是国立国语院《标准国语大词典》网站的官方“下载词典” 使用功能提供的转储数据。数据的著作权和使用条件为 遵守提供处政策。