1┌─────────────┐      ┌──────────┐      ┌─────────────┐
2│ Claude Code │ ←──→ │   MCP    │ ←──→ │  External   │
3│             │      │  Server  │      │  Resource   │
4└─────────────┘      └──────────┘      └─────────────┘
5                          ↓
6                    (Filesystem,
7                     Database,
8                     API, etc.)

1# Ensure Claude Code CLI is installed
2claude --version
3 
4# Node.js 18+ required for many MCPs
5node --version

1# Using npx (recommended)
2npx @modelcontextprotocol/server-filesystem
3 
4# Or install globally
5npm install -g @modelcontextprotocol/server-filesystem

1# Edit Claude Code config
2claude config edit
3 
4# Add MCP server configuration
5{
6  "mcpServers": {
7    "filesystem": {
8      "command": "npx",
9      "args": [
10        "@modelcontextprotocol/server-filesystem",
11        "/path/to/allowed/directory"
12      ]
13    }
14  }
15}

npm install -g @modelcontextprotocol/server-postgres
 
# Configure
claude config edit

1{
2  "mcpServers": {
3    "postgres": {
4      "command": "mcp-server-postgres",
5      "env": {
6        "DATABASE_URL": "postgresql://user:pass@localhost/dbname"
7      }
8    }
9  }
10}

List all Python files in my project directory
that were modified in the last 7 days.

1Connect to my PostgreSQL database and:
21. Show all tables
32. Count rows in 'users' table
43. Find users who signed up this week
54. Generate a summary report

1Analyze my git history and:
21. Show commit frequency by author
32. Identify files changed most often
43. Find commits related to authentication
54. Suggest areas that need refactoring based on churn

1# macOS (Homebrew)
2brew install --cask cursor
3 
4# Or download from website
5# https://cursor.sh/download

1// Before
2function fetchUser(id: string) {
3  return fetch(`/api/users/${id}`)
4}
5 
6// Select function, Cmd+K, type: "Add error handling and TypeScript types"
7 
8// After
9async function fetchUser(id: string): Promise<User | null> {
10  try {
11    const response = await fetch(`/api/users/${id}`)
12    if (!response.ok) {
13      throw new Error(`HTTP error! status: ${response.status}`)
14    }
15    return await response.json()
16  } catch (error) {
17    console.error('Failed to fetch user:', error)
18    return null
19  }
20}

1You: I need to add user authentication to my Next.js app
2 
3Claude: I can help you set up authentication. Let's use NextAuth.js.
4I'll guide you through:
51. Installing dependencies
62. Creating auth configuration
73. Adding login/logout pages
84. Protecting routes
9 
10Let's start. First, run:
11npm install next-auth
12 
13[Creates files as you go]

1You: Refactor my components to use TypeScript and add proper prop types
2 
3Claude: [Analyzes all component files]
4 
5I'll update these 12 files:
6- Header.jsx → Header.tsx
7- Button.jsx → Button.tsx
8- ...
9 
10[Shows diffs for all files]
11[You can review and apply changes]

1You: How does authentication work in this codebase?
2 
3Claude: [Analyzes your auth files]
4 
5Your app uses JWT-based authentication with these components:
6 
71. /lib/auth.ts - Core auth logic
82. /middleware.ts - Route protection
93. /api/login/route.ts - Login endpoint
10 
11The flow is:
121. User submits credentials to /api/login
132. Server validates and generates JWT
143. Token stored in HTTP-only cookie
154. Middleware checks token on protected routes
16 
17Would you like me to explain any specific part?

1# In terminal
2claude
3 
4> Connect to my database and show the users table schema
5> What are the most common user types?
6> Generate sample SQL queries for a user dashboard

1Build a Next.js dashboard showing:
21. Total users
32. Users by type (chart)
43. Recent signups (table)
54. Active users this week
6 
7Use the database schema you just analyzed.
8Create all necessary components with TypeScript and Tailwind.

1// weather-mcp/src/index.ts
2import { Server } from '@modelcontextprotocol/sdk/server/index.js'
3import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
4 
5const server = new Server({
6  name: 'weather-mcp',
7  version: '1.0.0',
8})
9 
10// Define a tool
11server.setRequestHandler('tools/call', async (request) => {
12  if (request.params.name === 'get_weather') {
13    const { city } = request.params.arguments
14 
15    // Call weather API
16    const response = await fetch(
17      `https://api.openweathermap.org/data/2.5/weather?q=${city}&appid=${process.env.API_KEY}`
18    )
19    const data = await response.json()
20 
21    return {
22      content: [{
23        type: 'text',
24        text: JSON.stringify(data, null, 2)
25      }]
26    }
27  }
28})
29 
30// Start server
31const transport = new StdioServerTransport()
32await server.connect(transport)

1# Build
2cd weather-mcp
3npm install
4npm run build
5 
6# Configure in Claude Code
7claude config edit

1{
2  "mcpServers": {
3    "weather": {
4      "command": "node",
5      "args": ["/path/to/weather-mcp/build/index.js"],
6      "env": {
7        "API_KEY": "your-api-key"
8      }
9    }
10  }
11}

Claude, what's the weather in San Francisco?

1# Check MCP status
2claude mcp list
3 
4# View logs
5claude mcp logs <server-name>
6 
7# Restart MCP
8claude mcp restart <server-name>

1# Fix file permissions
2chmod +x /path/to/mcp/server
3 
4# Check environment variables
5echo $DATABASE_URL