Claude Deep Think MCP Server

A powerful Model Context Protocol (MCP) server that provides proactive deep analytical thinking using Anthropic's Claude Sonnet 4.5. This tool is designed to be called BEFORE writing code when new information arrives.

⚡ Core Concept: Think Before Code

Use this tool FIRST when new information arrives, BEFORE writing any code:

• 🐛 Error messages or stack traces
• 📝 User requirements or feature requests
• 💬 Code review feedback
• 🚀 Performance issues
• 🔒 Security alerts
• 📚 API documentation to integrate
• 🗄️ Database problems
• 💭 UX/UI feedback
• 🔄 Breaking changes in dependencies
• 🏗️ Architectural decisions

Workflow: New Info → Think Tool → Review Insights → Write Better Code

🌟 Features

Deep Think & Analysis (claude_think)

Provides intelligent insights, suggestions, and strategic guidance before code implementation. Perfect for:

• ✅ Understanding context deeply before acting
• ✅ Identifying potential pitfalls upfront
• ✅ Suggesting best practices from the start
• ✅ Offering alternative approaches
• ✅ Extracting key information for efficient implementation
• ✅ Strategic decision-making
• ✅ Problem-solving and architecture planning

Result: Fewer bugs, better code quality, faster development!

📋 Prerequisites

• Node.js 18+ or Bun
• Anthropic Claude API key (Get one here)
• MCP-compatible client (Cursor IDE, Claude Desktop, etc.)

🚀 Quick Start

1. Installation

cd claude-vision-mcp
bun install
# or
npm install

2. Configuration

The API key is configured when connecting to the MCP server (see Docker or Cursor setup below).

3. Build

bun run build
# or
npm run build

🐳 Docker Setup (Recommended)

Quick Start

cd claude-vision-mcp

# Create .env file with your API key
echo "ANTHROPIC_API_KEY=your-key-here" > .env
echo "CLAUDE_MODEL=claude-sonnet-4-20250514" >> .env

# Start container
docker-compose up -d

# Check status
docker ps | grep claude-vision

The container will auto-restart when Docker Desktop launches.

Docker Configuration

The server runs on http://localhost:8080/mcp with the following environment variables:

• ANTHROPIC_API_KEY - Your Claude API key (required)
• CLAUDE_MODEL - Model to use (default: claude-sonnet-4-20250514)

🔧 Usage in Cursor IDE

Docker Connection (Recommended)

Add to your ~/.cursor/mcp.json or .cursor/mcp.json:

{
  "mcpServers": {
    "Claude Deep Think": {
      "url": "http://localhost:8080/mcp?apiKey=YOUR_API_KEY&model=claude-sonnet-4-5-20250929"
    }
  }
}

Enable Proactive Thinking

Copy the .cursorrules file from this repo to your project root. This makes Cursor AI automatically use the think tool before writing code.

# From your project directory
cp claude-vision-mcp/.cursorrules .cursorrules

Tool Usage Pattern

Always use this pattern when new information arrives:

Use the claude_think tool to analyze: [NEW INFORMATION]

Context: [Current situation, tech stack, constraints]

Examples:

Error Message:

Use the claude_think tool to analyze:

Error: "TypeError: Cannot read property 'map' of undefined"

Context: React component rendering users from useState hook

New Feature:

Use the claude_think tool:

Requirement: Add dark mode toggle to header

Context: Next.js 14, need to check if ThemeContext exists

Performance Issue:

Use the claude_think tool:

Issue: Homepage renders 50+ times, parent causing all children to re-render

Context: useState for theme in Header, passed via props to 20+ children

📚 Examples

Example 1: Analyzing Technical Decisions

Use the claude_think tool to analyze:

"I'm building a real-time chat application. Should I use WebSockets, SSE, or HTTP polling?"

Context: Need to support 100K concurrent users, prioritize ease of implementation

Expected Output: Compr

... View full README on GitHub