Dictionary Lookup MCP Server

公式Python SDKで構築された最小限のModel Context Protocolサーバーです。defineという1つのツールを公開しており、無料のdictionaryapi.dev APIを使用して英単語の定義を検索します。

このプロジェクトは、MCPサーバーの構造、クライアントとの通信方法、そして公開デプロイの方法を理解するための学習演習として構築されました。

機能

• 単一のツールを公開: define(word: str) -> str

• 単語を指定すると、品詞と定義を返します

• APIキーや認証は不要です

Related MCP server: Hello World MCP FastAPI Endpoint

必要条件

• Python 3.10+

• uv (推奨) または pip

セットアップ (ローカル)

# 1. Clone this repo
git clone <your-repo-url>
cd my-mcp-server

# 2. Install dependencies
uv sync

ローカルでの実行

オプションA — MCP Inspector (ビジュアルテストツール、初心者に最適):

uv run mcp dev server.py

これによりブラウザベースのインスペクタが開き、完全なAIクライアントを必要とせずにdefineツールを直接呼び出してリクエスト/レスポンスを確認できます。

オプションB — Claude Desktopに接続:

Claude Desktopの設定ファイル(claude_desktop_config.json)にこれを追加します:

{
  "mcpServers": {
    "dictionary-lookup": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/my-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

Claude Desktopを再起動し、次のように質問します: 「辞書ツールを使って'ephemeral'を定義してください。」

使用例

入力: define("ephemeral") 出力: ephemeral (adjective): lasting for a very short time.

デプロイ

このサーバーはSmitheryで公開されています: <link once deployed>

独自のコピーをデプロイするには:

1. このリポジトリをGitHubにプッシュします。

2. リモートホスティング用にserver.pyがstreamable-httpトランスポートをサポートしていることを確認します。

3. ホストするか(Render/Railwayなど)、Smitheryの公開フローを使用します。

4. Smitheryで「Publish via URL」を選択し、ホストしたサーバーのエンドポイントを指定します。

このプロジェクトの目的

MCPの基礎を学ぶために構築されました: クライアントがサーバーのツールをどのように発見するか、ツール呼び出しがどのように行われ応答されるか、そして動作するサーバーがSmitheryのようなマーケットプレイスを通じてどのように公開共有されるか。