clarity-mcp

# Clarity MCP Server A Model Context Protocol (MCP) server for interacting with the Clarity API. This server enables Cursor and other MCP-compatible clients to access Clarity backend services. ## Installation ### Prerequisites - Python 3.10 or higher (required for `fastmcp`) - `uv` package manager (recommended for this project) ### Installing uv **On macOS (using Homebrew):** ```bash brew install uv ``` **On Linux/macOS (using curl):** ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` **On Windows:** ```powershell powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" ``` ### Setting up the project Once `uv` is installed, it will automatically manage Python versions. You can install dependencies and run the server: ```bash # Install dependencies (uv will automatically use Python 3.10+) # IMPORTANT: Run this WITHOUT activating any venv - just run it directly uv sync # Install the package in editable mode so the 'clarity-mcp' command is available # This makes the entrypoint script available uv pip install -e . # Verify the installation worked uv run which clarity-mcp # Run the server locally (for development) uv run clarity-mcp ``` **Important Notes**: - **Never activate the venv manually** - just run `uv sync` and `uv run` directly in your shell - `uv sync` creates a `.venv` directory automatically, but you never need to activate/deactivate it - `uv pip install -e .` installs the package in editable mode, making the `clarity-mcp` command available - `uv run` automatically uses the venv that `uv` manages - this is "no manual virtualenv management" - `uvx clarity-mcp` will only work after the package is published to PyPI. For local development, use `uv run clarity-mcp` after running `uv sync` and `uv pip install -e .` The server will run over stdio and communicate with MCP clients. ## Configuration The server requires the following environment variables: - `CLARITY_EMAIL` (required): Your Clarity account email …