home / mcp / similar words mcp server

Similar Words MCP Server

An MCP server that exposes access to the Similar Words API for word similarity queries via stdio.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bach-ai-tools-bachai-similar-words": {
      "command": "uvx",
      "args": [
        "--from",
        "bach-similar_words",
        "bach_similar_words"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You can run this MCP Server to access the Similar Words API from your applications. It uses stdio for communication and lets you start the server locally via uvx or Python, making it easy to integrate word similarity lookups into your workflows while keeping credentials secure.

How to use

You will run the MCP Server as a local, stdio-based service. Use an MCP client to connect to it and perform similarity lookups against the Similar Words API. Ensure you set the required API key as an environment variable before starting the server.

How to install

Prerequisites you need before installation:

- Python installed on your system for local install options.

- Pip to manage Python packages.

Step-by-step commands

# Install the package from PyPI
pip install bach-similar_words

# Run the server using uvx (recommended)
uvx --from bach-similar_words bach_similar_words

# Or run in development mode using Python directly
python server.py

Configuration and running guidelines

This server requires an API key. Set the API key in your environment before starting the server.

Environment variable to set before starting the server:

Additional configuration details

{
  "mcpServers": {
    "bach-similar_words": {
      "command": "uvx",
      "args": ["--from", "bach-similar_words", "bach_similar_words"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Security notes

Protect your API key. Do not commit it to version control. Use environment variables in your deployment environment and limit access to the MCP client.

Troubleshooting

If you encounter connection issues, verify that the API key is set correctly and that the uvx command is available in your PATH. Check that the environment variable API_KEY is exported in the shell or defined in your MCP client configuration.

Notes

You can also run the server in development mode using Python with python server.py if you are actively developing or debugging the integration.

Available tools

server_launch

Launch the MCP server using uvx from the bach-similar_words package to expose the Similar Words API via stdio.