国立国语院标准国语大辞典 MCP 服务器

这是一个用 TypeScript 编写的包，它将国立国语院标准国语大辞典 API 提供为 MCP (Model Context Protocol) 服务器。

简介

此项目将 国立国语院标准国语大辞典开放 API 转换为 MCP (Model Context Protocol) 服务器，帮助像 Claude 和 ChatGPT 这样的大规模语言模型 (LLM) 访问和利用韩语词典信息。

安装

可以通过 NPM 进行安装：

# 全局安装
npm install -g koreandict-mcp-server

# 在本地项目中安装
npm install koreandict-mcp-server

配置

在运行服务器之前，需要设置从国立国语院获得的 API 密钥。可以选择以下两种方法之一：

1. 使用环境变量

创建一个 .env 文件并设置 API 密钥：

KOREANDICT_API_KEY=your-api-key-here

2. 使用 MCP 配置文件

创建一个 mcp.json 文件，并进行如下设置：

{
  "koreandict-server": {
    "command": "node",
    "args": [
      "./dist/index.js"
    ],
    "env": {
      "KOREANDICT_API_KEY": "your-api-key-here"
    }
  }
}

此配置文件可以位于当前目录或家目录的 .cursor/mcp.json 中。

使用方法

直接执行

如果全局安装了该包，则可以在命令行中这样执行：

koreandict-mcp-server

通过编程方式使用

如果在项目中安装了该包，可以在代码中这样使用：

import { KoreanDictionaryMcpServer } from 'koreandict-mcp-server';

// 创建服务器实例
const server = new KoreanDictionaryMcpServer();

// 启动服务器
server.getServer().listen();

在 MCP 客户端中使用

要在 MCP 客户端（如 Cursor）中使用，需要在客户端的 MCP 设置中添加服务器信息。通常需要修改 ~/.cursor/mcp.json 文件：

{
  "koreandict-server": {
    "command": "koreandict-mcp-server",
    "env": {
      "KOREANDICT_API_KEY": "your-api-key-here"
    }
  }
}

功能

MCP 资源

• koreandict://word/{word} - 提供单词搜索结果。
• koreandict://pos/{pos}/word/{word} - 按词性提供单词搜索结果。

MCP 工具

• search-word - 搜索单词。可以指定搜索方式和结果数量。
• search-by-pos - 按词性搜索单词。

开发

克隆存储库

# 克隆存储库
git clone https://github.com/tenacl/koreandict-mcp-server.git
cd koreandict-mcp-server

# 安装依赖
npm install

# 运行开发服务器
npm run dev

# 构建
npm run build

测试

npm test

故障排除

MCP 连接错误

如果遇到 MCP 连接错误，请检查以下内容：

1. 确认 API 密钥已正确设置。
2. 确认 mcp.json 文件中的路径设置正确。
3. 查看日志中的错误消息。

贡献

请通过 GitHub 存储库 提交问题和拉取请求。

许可证

MIT

参考资料

• 国立国语院标准国语大辞典
• Model Context Protocol
• MCP TypeScript SDK