clink-mcp-server: Instructions file for Claude Code

Clink MCP Server - Development Guide

This is the MCP server for Clink, published to npm as @voxos-ai/clink-mcp-server.

Source Location

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

• GitHub: https://github.com/Voxos-ai-Inc/clink-mcp-server
• npm: https://www.npmjs.com/package/@voxos-ai/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 (already done)

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

Publishing changes

After making changes to projects/clink/mcp/:

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

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

Or use the make target:

make mcp-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
• The .gitignore excludes node_modules/ and dist/ from GitHub

Publishing to npm

After pushing to GitHub:

cd projects/clink/mcp
npm version patch  # or minor/major
npm publish --access public

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

Development

cd projects/clink/mcp
npm install
npm run build
npm run dev  # watch mode

Testing locally with Claude Code

1. Build the server: npm run build
2. Update your ~/.claude.json to use the local build:

{
  "mcpServers": {
    "clink": {
      "command": "node",
      "args": ["/path/to/voxos/projects/clink/mcp/dist/index.js"],
      "env": {
        "CLINK_API_KEY": "sk_live_...",
        "CLINK_API_URL": "https://api.clink.stg.voxos.ai"
      }
    }
  }
}