clink-mcp-server-python CLAUDE.md

Clink MCP Server (Python) - Development Guide

This is the Python MCP server for Clink, published to PyPI as clink-mcp-server.

Source Location

This code lives in the voxos monorepo at projects/clink/mcp-python/ and is published to:

• GitHub: https://github.com/Voxos-ai-Inc/clink-mcp-server-python
• PyPI: https://pypi.org/project/clink-mcp-server/

Publishing to GitHub

This directory is synced to GitHub using git subtree. The GitHub repo is a mirror of this subdirectory.

First-time setup

# Add the GitHub remote
git remote add github-mcp-python [email protected]:Voxos-ai-Inc/clink-mcp-server-python.git

Publishing changes

After making changes to projects/clink/mcp-python/:

# 1. Commit your changes to the monorepo
git add projects/clink/mcp-python/
git commit -m "feat(mcp-python): your change description"

# 2. Push the subdirectory to GitHub
git subtree push --prefix=projects/clink/mcp-python github-mcp-python main

Or use the make target:

make mcp-python-publish

Important notes

• Always commit to the monorepo first, then push to GitHub
• The GitHub repo's main branch mirrors this directory
• Don't edit the GitHub repo directly - changes flow monorepo -> GitHub only

Publishing to PyPI

After pushing to GitHub:

cd projects/clink/mcp-python

# Bump version in pyproject.toml, then:
uv build
uv publish

Or with hatch:

hatch version patch  # or minor/major
hatch build
hatch publish

Then commit the version bump to the monorepo and push to GitHub again.

Development

Setup

cd projects/clink/mcp-python
uv venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e ".[dev]"

Testing locally with Claude Code

1. Update your ~/.claude.json to use the local source:

{
  "mcpServers": {
    "clink": {
      "command": "python",
      "args": ["-m", "clink_mcp_server"],
      "env": {
        "CLINK_API_KEY": "sk_live_...",
        "CLINK_API_URL": "https://api.stg.clink.voxos.ai",
        "PYTHONPATH": "/path/to/voxos/projects/clink/mcp-python/src"
      }
    }
  }
}