Dictionary Lookup MCP Server

Минимальный сервер Model Context Protocol, созданный с помощью официального Python SDK. Он предоставляет один инструмент, define, который ищет определение английского слова с помощью бесплатного 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

Откроется браузерный инспектор, где вы можете напрямую вызывать инструмент define и видеть запрос/ответ без необходимости в полноценном AI-клиенте.

Вариант 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, затем спросите что-то вроде: "Используйте словарный инструмент, чтобы вызвать define для '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» и направьте его на endpoint вашего размещенного сервера.

Зачем этот проект

Создан для изучения основ MCP: как клиент обнаруживает инструменты сервера, как выполняется и обрабатывается вызов инструмента и как работающий сервер публикуется через маркетплейс вроде Smithery.