WordNet MCP 服务

这是一个基于WordNet的Model Context Protocol (MCP) 服务实现，提供词汇查询功能，包括同义词、反义词、上下位词和定义等。

项目地址

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

功能

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

安装

通过 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. 使用服务进行词汇查询

开发

安装开发依赖

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

使用 Makefile

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

# 递增版本号
make bump-version

# 构建包
make build

# 发布到PyPI
make publish

# 本地安装
make install

# 运行测试
make test

# 清理构建文件
make clean

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