claude-tools-mcp: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is an MCP (Model Context Protocol) server that exposes Claude Code's file and shell tools over HTTP, allowing other MCP clients to use these tools remotely. The server runs in stateless mode for horizontal scaling.

Development Commands

Building

go build -o claude-tools-mcp ./cmd/claude-tools-mcp

Running Tests

# Run all tests
go test ./...

# Run tests for a specific package
go test ./internal/tools

# Run a specific test
go test -run TestFunctionName ./internal/tools

Running the Server

# Default (localhost:8080)
go run ./cmd/claude-tools-mcp

# Custom address
go run ./cmd/claude-tools-mcp --addr localhost:9000

Releases

The project uses GoReleaser for automated releases.

Creating a Release

1. Tag a version: Create and push a git tag with semantic versioning:

   git tag -a v0.1.0 -m "Release v0.1.0"
   git push origin v0.1.0
   

2. Automated build: GitHub Actions will automatically:

   • Run tests
   • Build binaries for multiple platforms (Linux, macOS, Windows on amd64/arm64)
   • Create archives with checksums
   • Generate changelog from commits
   • Create a GitHub release with all artifacts

Local Testing

Test the release configuration locally without publishing:

# Install goreleaser (if not already installed)
go install github.com/goreleaser/goreleaser/v2@latest

# Test release build (no publishing)
goreleaser release --snapshot --clean

# Check what would be released
goreleaser check

Release Artifacts

Each release includes:

• Pre-built binaries for Linux, macOS, and Windows (amd64 and arm64)
• Compressed archives (tar.gz for Unix, zip for Windows)
• SHA256 checksums for verification
• Automatically generated changelog

Architecture

Core Components

cmd/claude-tools-mcp/main.go: HTTP server entrypoint