slack-claude-code-integration: 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 a Slack integration system that enables teams to use Claude Code through Slack using the Model Context Protocol (MCP). The architecture follows:

Slack → Slack Bot → Claude Code MCP Server → Claude Code CLI

Essential Commands

Development

# Initial setup (installs all dependencies)
npm run setup

# Build TypeScript code
npm run build         # One-time build
npm run build:watch   # Watch mode for development

# Run in development mode (builds and watches)
npm run dev

# Run tests (currently placeholder)
npm test

# Code quality
npm run lint          # Check TypeScript and JavaScript files
npm run lint:fix      # Auto-fix lint errors  
npm run format        # Format all code with Prettier
npm run format:check  # Check formatting

# Start in test mode (uses echo instead of Claude CLI)
./start-test.sh

Docker Operations

npm run docker:build  # Build Docker images
npm run docker:up     # Start services
npm run docker:down   # Stop services

Git Hooks

Lefthook is configured to run pre-commit checks automatically. To manually install:

npx lefthook install

Architecture

Component Structure

• claude-code-mcp/: MCP server that wraps Claude Code CLI (TypeScript)

  • Source: claude-code-mcp/index.ts
  • Built to: dist/claude-code-mcp/index.js
  • Implements stdio-based MCP protocol
  • Handles tools/list and tools/call methods
  • Spawns Claude CLI or echo (test mode) as child process

• slack-bot/: Slack Bolt application (TypeScript)

  • Source: slack-bot/index.ts
  • Built to: dist/slack-bot/index.js
  • Connects to MCP server as client
  • Handles app mentions, DMs, and slash commands
  • Manages project path switching via --project flag

Key Integration Points

1. MCP Communication: The Slack bot creates a StdioClientTransport to communicate with the MCP server, which runs as a separate Node.js process.