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