🚀 WordNet MCP 服务
WordNet MCP 服务是基于 WordNet 的 Model Context Protocol (MCP) 服务实现，能提供丰富的词汇查询功能，如同义词、反义词、上下位词和定义等，助力用户高效获取词汇相关信息。
🚀 快速开始
WordNet MCP 服务可提供便捷的词汇查询功能。您可以按照以下步骤进行安装和使用：
- 按照“📦 安装指南”中的步骤完成服务的安装。
- 参考“💻 使用示例”进行词汇查询。
✨ 主要特性
- 查询单词的同义词
- 查询单词的反义词
- 查询单词的上位词（更一般的概念）
- 查询单词的下位词（更具体的概念）
- 查询单词的定义和例句
- 获取单词的综合信息
📦 安装指南
通过 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 服务
- 在 Cursor 中安装 MCP 服务。
- 添加 WordNet MCP 服务（使用上述方法之一）。
- 使用服务进行词汇查询。
📚 详细文档
这个文档详细介绍了如何安装、使用和开发 WordNet MCP 服务，包括命令行操作和集成配置。
🔧 技术细节
安装开发依赖
# 安装开发依赖
uv pip install -e ".[dev]"
使用 Makefile
项目提供了 Makefile，可以轻松进行开发和发布操作：
# 递增版本号
make bump-version
# 构建包
make build
# 发布到 PyPI
make publish
# 本地安装
make install
# 运行测试
make test
# 清理构建文件
make clean