MCP 服务器

국립국어원 표준국어대사전 MCP 서버

tenacl

开发者工具

访问服务器

README

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

这是一个 TypeScript 包，用于将国立国语院标准韩国语大辞典 API 作为 MCP（模型上下文协议）服务器提供。

介绍

本项目将国立国语院标准韩国语大辞典开放 API转换为 MCP（模型上下文协议）服务器并提供。它可以帮助 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