Wordnet MCP Server

🚀 WordNet MCP サービス

このサービスはWordNetに基づくModel Context Protocol (MCP) の実装で、同義語、反義語、上位下位語、定義などの単語検索機能を提供します。

🚀 クイックスタート

WordNet MCPサービスは、WordNetを利用して単語に関する様々な情報を取得できる便利なサービスです。以下に、サービスのインストール、使用方法、開発に関する詳細を説明します。

✨ 主な機能

• 単語の同義語を検索する
• 単語の反義語を検索する
• 単語の上位語（より一般的な概念）を検索する
• 単語の下位語（より具体的な概念）を検索する
• 単語の定義と例文を検索する
• 単語の総合的な情報を取得する

📦 インストール

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サービスのインストール、使用、開発に関する詳細を説明しています。コマンドライン操作や統合設定など、様々な面での使い方を網羅しています。

🔍 プロジェクトのURL

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