Skip to content

Commit 5914dc4

Browse files
zealoushackerzealoushacker
committed
refactor: Remove Claude Desktop references in favor of Claude Code
- Update all configuration examples to use claude mcp add command - Remove references to claude_desktop_config.json - Remove import-from-desktop instructions - Simplify setup process for learners - Focus exclusively on Claude Code usage
1 parent 9f88871 commit 5914dc4

File tree

8 files changed

+56
-161
lines changed

8 files changed

+56
-161
lines changed

‎projects/unit3/build-mcp-server/solution/README.md‎

Lines changed: 5 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -20,35 +20,14 @@ uv sync --all-extras
2020

2121
### 3. Configure the MCP Server
2222

23-
#### Option 1: Configure in Claude Desktop first (Recommended)
24-
25-
1. Add to your Claude Desktop MCP settings (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
26-
27-
```json
28-
{
29-
"mcpServers": {
30-
"pr-agent": {
31-
"command": "uv",
32-
"args": [
33-
"--directory",
34-
"/absolute/path/to/module1/solution",
35-
"run",
36-
"server.py"
37-
]
38-
}
39-
}
40-
}
41-
```
23+
Add the server to Claude Code:
4224

43-
2. Import into Claude Code using the [import command](https://docs.anthropic.com/en/docs/claude-code/tutorials#import-mcp-servers-from-claude-desktop):
4425
```bash
45-
claude mcp import-from-desktop
46-
```
26+
# Add the MCP server
27+
claude mcp add pr-agent "uv" "--directory" "/absolute/path/to/module1/solution" "run" "server.py"
4728

48-
#### Option 2: Add directly to Claude Code
49-
50-
```bash
51-
claude mcp add pr-agent -- uv --directory /absolute/path/to/module1/solution run server.py
29+
# Verify it's configured
30+
claude mcp list
5231
```
5332

5433
## Tools Available

‎projects/unit3/build-mcp-server/solution/manual_test.md‎

Lines changed: 11 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -30,34 +30,20 @@ This will check:
3030
uv run pytest test_server.py -v
3131
```
3232

33-
## Test 3: Test with Claude
33+
## Test 3: Test with Claude Code
3434

35-
1. **Configure MCP Settings**
35+
1. **Configure MCP Server**
3636

37-
Add to your Claude Desktop MCP settings (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
38-
39-
```json
40-
{
41-
"mcpServers": {
42-
"pr-agent": {
43-
"command": "uv",
44-
"args": [
45-
"--directory",
46-
"/absolute/path/to/module1/solution",
47-
"run",
48-
"server.py"
49-
]
50-
}
51-
}
52-
}
53-
```
54-
55-
2. **Import to Claude Code** ([documentation](https://docs.anthropic.com/en/docs/claude-code/tutorials#import-mcp-servers-from-claude-desktop)):
37+
Add the server to Claude Code:
5638
```bash
57-
claude mcp import-from-desktop
39+
# Add the MCP server
40+
claude mcp add pr-agent "uv" "--directory" "/absolute/path/to/module1/solution" "run" "server.py"
41+
42+
# Verify it's configured
43+
claude mcp list
5844
```
5945

60-
3. **Restart Claude Desktop/Code** to pick up the new server
46+
2. **Restart Claude Code** to pick up the new server
6147

6248
3. **Make Some Git Changes**
6349

@@ -125,5 +111,5 @@ asyncio.run(test())
125111

126112
- **"Git not found"**: Ensure you're in a git repository
127113
- **Import errors**: Check virtual environment is activated
128-
- **MCP connection failed**: Verify the path in Claude Code settings is absolute
129-
- **No tools showing**: Restart Claude Code after config changes
114+
- **MCP connection failed**: Verify the path in the claude mcp add command is absolute
115+
- **No tools showing**: Restart Claude Code after adding the server

‎projects/unit3/build-mcp-server/starter/README.md‎

Lines changed: 5 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -50,35 +50,13 @@ Instead of using rigid rules based on file extensions or patterns, your tools sh
5050
uv run pytest test_server.py -v
5151
```
5252

53-
2. Configure the MCP server:
54-
55-
**Option 1: Configure in Claude Desktop first (Recommended)**
56-
57-
Add to Claude Desktop settings (`~/Library/Application Support/Claude/claude_desktop_config.json`):
58-
```json
59-
{
60-
"mcpServers": {
61-
"pr-agent": {
62-
"command": "uv",
63-
"args": [
64-
"--directory",
65-
"/absolute/path/to/module1/starter",
66-
"run",
67-
"server.py"
68-
]
69-
}
70-
}
71-
}
72-
```
73-
74-
Then import into Claude Code:
53+
2. Configure the MCP server in Claude Code:
7554
```bash
76-
claude mcp import-from-desktop
77-
```
55+
# Add the MCP server
56+
claude mcp add pr-agent "uv" "--directory" "/absolute/path/to/module1/starter" "run" "server.py"
7857

79-
**Option 2: Add directly to Claude Code**
80-
```bash
81-
claude mcp add pr-agent -- uv --directory /absolute/path/to/module1/starter run server.py
58+
# Verify it's configured
59+
claude mcp list
8260
```
8361

8462
3. Make some changes in a git repository and ask Claude to analyze your changes and suggest a PR template

‎projects/unit3/build-mcp-server/starter/server.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
# Initialize the FastMCP server
1414
mcp = FastMCP("pr-agent")
1515

16-
# PR template directory (shared between starter and solution)
16+
# PR template directory (shared across all modules)
1717
TEMPLATES_DIR = Path(__file__).parent.parent.parent / "templates"
1818

1919

‎projects/unit3/smart-file-analysis/solution/README.md‎

Lines changed: 6 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -29,26 +29,13 @@ uv run server.py
2929

3030
## Testing
3131

32-
Configure in Claude Desktop:
33-
```json
34-
{
35-
"mcpServers": {
36-
"pr-agent": {
37-
"command": "uv",
38-
"args": [
39-
"--directory",
40-
"/path/to/smart-file-analysis/solution",
41-
"run",
42-
"server.py"
43-
]
44-
}
45-
}
46-
}
47-
```
48-
49-
Then import to Claude Code:
32+
Configure in Claude Code:
5033
```bash
51-
claude mcp import-from-desktop
34+
# Add the MCP server
35+
claude mcp add pr-agent "uv" "--directory" "/path/to/smart-file-analysis/solution" "run" "server.py"
36+
37+
# Verify configuration
38+
claude mcp list
5239
```
5340

5441
## Project Structure

‎projects/unit3/smart-file-analysis/solution/manual_test.md‎

Lines changed: 10 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -22,36 +22,22 @@ You should see:
2222
- Templates: bug.md, feature.md, docs.md, etc.
2323
- Team guidelines: coding-standards.md, pr-guidelines.md
2424

25-
## Test 2: Test with Claude
25+
## Test 2: Test with Claude Code
2626

27-
1. **Configure MCP Settings**
27+
1. **Configure MCP Server**
2828

29-
Add to your Claude Desktop MCP settings (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
30-
31-
```json
32-
{
33-
"mcpServers": {
34-
"pr-agent": {
35-
"command": "uv",
36-
"args": [
37-
"--directory",
38-
"/absolute/path/to/smart-file-analysis/solution",
39-
"run",
40-
"server.py"
41-
]
42-
}
43-
}
44-
}
45-
```
46-
47-
2. **Import to Claude Code** ([documentation](https://docs.anthropic.com/en/docs/claude-code/tutorials#import-mcp-servers-from-claude-desktop)):
29+
Add the server to Claude Code:
4830
```bash
49-
claude mcp import-from-desktop
31+
# Add the MCP server
32+
claude mcp add pr-agent "uv" "--directory" "/absolute/path/to/smart-file-analysis/solution" "run" "server.py"
33+
34+
# Verify it's configured
35+
claude mcp list
5036
```
5137

52-
3. **Restart Claude Desktop/Code** to pick up the new server
38+
2. **Restart Claude Code** to pick up the new server
5339

54-
4. **Test Resource Access**
40+
3. **Test Resource Access**
5541

5642
Ask Claude to test the new resources:
5743
- "What are our team's coding standards?"

‎units/en/unit3/build-mcp-server.mdx‎

Lines changed: 8 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -76,29 +76,16 @@ Test your implementation with the provided test suite:
7676
uv run pytest test_server.py -v
7777
```
7878

79-
### 3. Test with Claude
80-
81-
Configure your server in Claude Desktop settings, then import to Claude Code ([see documentation](https://docs.anthropic.com/en/docs/claude-code/tutorials#import-mcp-servers-from-claude-desktop)):
82-
83-
```json
84-
{
85-
"mcpServers": {
86-
"pr-agent": {
87-
"command": "uv",
88-
"args": [
89-
"--directory",
90-
"/absolute/path/to/starter",
91-
"run",
92-
"server.py"
93-
]
94-
}
95-
}
96-
}
97-
```
79+
### 3. Test with Claude Code
80+
81+
Configure your server directly in Claude Code:
9882

9983
```bash
100-
# Import Claude Desktop servers into Claude Code
101-
claude mcp import-from-desktop
84+
# Add the MCP server to Claude Code
85+
claude mcp add pr-agent "uv" "--directory" "/absolute/path/to/starter" "run" "server.py"
86+
87+
# Verify the server is configured
88+
claude mcp list
10289
```
10390

10491
Then:

‎units/en/unit3/smart-file-analysis.mdx‎

Lines changed: 10 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -104,24 +104,16 @@ ls projects/unit3/team-guidelines/
104104
# Should show: coding-standards.md, pr-guidelines.md
105105
```
106106

107-
### 2. Test with Claude
108-
109-
Update your Claude Desktop configuration and import to Claude Code:
110-
111-
```json
112-
{
113-
"mcpServers": {
114-
"pr-agent": {
115-
"command": "uv",
116-
"args": [
117-
"--directory",
118-
"/absolute/path/to/smart-file-analysis/starter",
119-
"run",
120-
"server.py"
121-
]
122-
}
123-
}
124-
}
107+
### 2. Test with Claude Code
108+
109+
Configure your server in Claude Code:
110+
111+
```bash
112+
# Add the MCP server
113+
claude mcp add pr-agent "uv" "--directory" "/absolute/path/to/smart-file-analysis/starter" "run" "server.py"
114+
115+
# Verify it's configured
116+
claude mcp list
125117
```
126118

127119
Then ask Claude:

0 commit comments

Comments
 (0)