Wordnet MCP Server

🚀 WordNet MCP 服务

WordNet MCP 服务是基于 WordNet 的 Model Context Protocol (MCP) 服务实现，能提供丰富的词汇查询功能，如同义词、反义词、上下位词和定义等，助力用户高效获取词汇相关信息。

🚀 快速开始

WordNet MCP 服务可提供便捷的词汇查询功能。您可以按照以下步骤进行安装和使用：

1. 按照“📦 安装指南”中的步骤完成服务的安装。
2. 参考“💻 使用示例”进行词汇查询。

✨ 主要特性

• 查询单词的同义词
• 查询单词的反义词
• 查询单词的上位词（更一般的概念）
• 查询单词的下位词（更具体的概念）
• 查询单词的定义和例句
• 获取单词的综合信息

📦 安装指南

通过 PyPI 安装

推荐使用 uv 安装:

# 安装 wordnet-mcp-server
uvx wordnet-mcp-server

或者使用 pip:

# 安装 wordnet-mcp-server
pip install wordnet-mcp-server

从源码安装

# 克隆仓库
git clone https://github.com/keepondream/wordnet-mcp-server.git
cd wordnet-mcp-server

# 安装依赖和项目
uv pip install -e .

💻 使用示例

基础用法

直接运行

安装后，可以直接使用命令行运行服务:

# 使用入口点运行
wordnet-mcp

# 或者使用 Python 模块运行
python -m wordnet_mcp_server

高级用法

在 MCP 客户端中配置服务

方法一：直接使用 uvx 命令（推荐）

当服务发布到 PyPI 后，您可以直接使用 uvx 命令配置（最简单的方式）：

{
  "mcpServers": {
    "wordnet": {
      "command": "python3",
      "type": "stdio",
      "args": ["-m", "wordnet_mcp_server"]
    }
  }
}

方法二：指定 Python 解释器和模块路径

{
  "mcpServers": {
    "WordNet MCP": {
      "command": "python3",
      "type": "stdio",
      "args": ["-m", "wordnet_mcp_server"]
    }
  }
}

在 Cursor 中添加 MCP 服务

1. 在 Cursor 中安装 MCP 服务。
2. 添加 WordNet MCP 服务（使用上述方法之一）。
3. 使用服务进行词汇查询。

📚 详细文档

这个文档详细介绍了如何安装、使用和开发 WordNet MCP 服务，包括命令行操作和集成配置。

🔧 技术细节

安装开发依赖

# 安装开发依赖
uv pip install -e ".[dev]"

使用 Makefile

项目提供了 Makefile，可以轻松进行开发和发布操作：

# 递增版本号
make bump-version

# 构建包
make build

# 发布到 PyPI
make publish

# 本地安装
make install

# 运行测试
make test

# 清理构建文件
make clean

项目地址

GitHub: github.com/keepondream/wordnet-mcp-server