casual-mcp-server-words 1.0.0

Dictionary and thesaurus utilities as a FastMCP server

Words MCP Server

An MCP server providing dictionary and thesaurus tools for LLMs using the Free Dictionary API.

---

Overview

The Words MCP Server provides natural language utilities for language models and AI assistants. It allows tools like define, synonyms, and example_usage to be called programmatically via FastMCP.

---

🔧 Tools

• define – Retrieve definitions of an English word.
• example_usage – Get example usage sentences for a word.
• synonyms – Get synonyms for a word.

---

🛠️ Installation

Local Development (via uv)

From this directory:

uv sync --locked
uv tool install .

Docker Build

From the root of the repository:

docker build -f servers/words/Dockerfile -t casual-mcp-server-words .

---

▶️ Running the Server

➤ Stdio Mode

From Source

Install for local development and then configure:

{
  "mcpServers": {
    "words": {
      "command": "uv",
      "args": ["tool", "run", "casual-mcp-server-words"]
    }
  }
}

Using uvx

{
  "mcpServers": {
    "words": {
      "command": "uvx",
      "args": ["casual-mcp-server-words"]
    }
  }
}

Docker

{
  "mcpServers": {
    "words": {
      "command": "docker",
      "args": ["run", "--rm", "casual-mcp-server-words"]
    }
  }
}

---

➤ Streamable HTTP Mode

From Source

uv run casual-mcp-server-words --transport streamable-http

With port/host overrides:

uv run casual-mcp-server-words --transport streamable-http --port 9000 --host 0.0.0.0

Using uvx

uvx casual-mcp-server-words --transport streamable-http

You can use the same port/host overrides as above

Docker

docker run -e MCP_TRANSPORT=streamable-http -e MCP_PORT=9000 -p 9000:9000 casual-mcp-server-words

Configuration

{
  "mcpServers": {
    "words": {
      "type": "streamable-http",
      "url": "http://localhost:9000"
    }
  }
}

---

📜 License

MIT – LICENSE

---

📦 PyPI

Published at: https://pypi.org/project/casual-mcp-server-words/