aios-core 2.1.3 → 2.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -2,7 +2,23 @@
|
|
|
2
2
|
paths: **/*
|
|
3
3
|
---
|
|
4
4
|
|
|
5
|
-
# MCP Server Usage Rules
|
|
5
|
+
# MCP Server Usage Rules - AIOS Architecture
|
|
6
|
+
|
|
7
|
+
## MCP Configuration Architecture
|
|
8
|
+
|
|
9
|
+
AIOS uses a hybrid MCP architecture for optimal performance and security:
|
|
10
|
+
|
|
11
|
+
### Direct in Claude Code (global ~/.claude.json)
|
|
12
|
+
| MCP | Purpose |
|
|
13
|
+
|-----|---------|
|
|
14
|
+
| **playwright** | Browser automation, screenshots, web testing |
|
|
15
|
+
| **desktop-commander** | Docker container operations via docker-gateway |
|
|
16
|
+
|
|
17
|
+
### Inside Docker Desktop (via desktop-commander)
|
|
18
|
+
| MCP | Purpose |
|
|
19
|
+
|-----|---------|
|
|
20
|
+
| **EXA** | Web search, research, company/competitor analysis |
|
|
21
|
+
| **Context7** | Library documentation lookup |
|
|
6
22
|
|
|
7
23
|
## CRITICAL: Tool Selection Priority
|
|
8
24
|
|
|
@@ -17,38 +33,68 @@ ALWAYS prefer native Claude Code tools over MCP servers:
|
|
|
17
33
|
| Search content | `Grep` tool | docker-gateway |
|
|
18
34
|
| List directories | `Bash(ls)` or `Glob` | docker-gateway |
|
|
19
35
|
|
|
20
|
-
## docker-gateway
|
|
36
|
+
## desktop-commander (docker-gateway) Usage
|
|
21
37
|
|
|
22
38
|
### ONLY use docker-gateway when:
|
|
23
39
|
1. User explicitly says "use docker" or "use container"
|
|
24
40
|
2. User explicitly mentions "Desktop Commander"
|
|
25
41
|
3. Task specifically requires Docker container operations
|
|
26
|
-
4.
|
|
42
|
+
4. Accessing MCPs running inside Docker (EXA, Context7)
|
|
43
|
+
5. User asks to run something inside a Docker container
|
|
27
44
|
|
|
28
45
|
### NEVER use docker-gateway for:
|
|
29
46
|
- Reading local files (use `Read` tool)
|
|
30
47
|
- Writing local files (use `Write` or `Edit` tools)
|
|
31
|
-
- Running shell commands (use `Bash` tool)
|
|
48
|
+
- Running shell commands on host (use `Bash` tool)
|
|
32
49
|
- Searching files (use `Glob` or `Grep` tools)
|
|
33
50
|
- Listing directories (use `Bash(ls)` or `Glob`)
|
|
34
|
-
- Running Node.js or Python scripts (use `Bash` tool)
|
|
51
|
+
- Running Node.js or Python scripts on host (use `Bash` tool)
|
|
35
52
|
|
|
36
|
-
## playwright MCP
|
|
53
|
+
## playwright MCP Usage
|
|
37
54
|
|
|
38
55
|
### ONLY use playwright when:
|
|
39
56
|
1. User explicitly asks for browser automation
|
|
40
57
|
2. User wants to take screenshots of web pages
|
|
41
58
|
3. User needs to interact with a website
|
|
42
59
|
4. Task requires web scraping or testing
|
|
60
|
+
5. Filling forms or clicking elements on web pages
|
|
43
61
|
|
|
44
62
|
### NEVER use playwright for:
|
|
45
63
|
- General file operations
|
|
46
64
|
- Running commands
|
|
47
65
|
- Anything not related to web browsers
|
|
48
66
|
|
|
67
|
+
## EXA MCP Usage (via Docker)
|
|
68
|
+
|
|
69
|
+
### Use EXA (mcp__docker-gateway__web_search_exa) for:
|
|
70
|
+
1. Web searches for current information
|
|
71
|
+
2. Research and documentation lookup
|
|
72
|
+
3. Company and competitor research
|
|
73
|
+
4. Finding code examples online
|
|
74
|
+
|
|
75
|
+
### Access pattern:
|
|
76
|
+
```
|
|
77
|
+
mcp__docker-gateway__web_search_exa
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## Context7 MCP Usage (via Docker)
|
|
81
|
+
|
|
82
|
+
### Use Context7 for:
|
|
83
|
+
1. Library documentation lookup
|
|
84
|
+
2. API reference for packages/frameworks
|
|
85
|
+
3. Getting up-to-date docs for dependencies
|
|
86
|
+
|
|
87
|
+
### Access pattern:
|
|
88
|
+
```
|
|
89
|
+
mcp__docker-gateway__resolve-library-id
|
|
90
|
+
mcp__docker-gateway__get-library-docs
|
|
91
|
+
```
|
|
92
|
+
|
|
49
93
|
## Rationale
|
|
50
94
|
|
|
51
|
-
- Native tools execute on the LOCAL system (Windows)
|
|
52
|
-
- docker-gateway executes inside Docker containers (Linux)
|
|
95
|
+
- **Native tools** execute on the LOCAL system (Windows/Mac/Linux)
|
|
96
|
+
- **docker-gateway** executes inside Docker containers (Linux)
|
|
53
97
|
- Using docker-gateway for local operations causes path mismatches and failures
|
|
54
|
-
- Native tools are faster and more reliable for local operations
|
|
98
|
+
- Native tools are faster and more reliable for local file operations
|
|
99
|
+
- EXA and Context7 run inside Docker for isolation and consistent environment
|
|
100
|
+
- playwright runs directly for better browser integration with host system
|
package/package.json
CHANGED
|
@@ -118,7 +118,7 @@ VERCEL_TOKEN=
|
|
|
118
118
|
# AIOS Core Configuration
|
|
119
119
|
# --------------------------------------------
|
|
120
120
|
NODE_ENV=development
|
|
121
|
-
AIOS_VERSION=2.1.
|
|
121
|
+
AIOS_VERSION=2.1.4
|
|
122
122
|
|
|
123
123
|
# --------------------------------------------
|
|
124
124
|
# Custom Configuration
|
|
@@ -230,7 +230,7 @@ VERCEL_TOKEN=
|
|
|
230
230
|
# AIOS Core Configuration
|
|
231
231
|
# --------------------------------------------
|
|
232
232
|
NODE_ENV=development
|
|
233
|
-
AIOS_VERSION=2.1.
|
|
233
|
+
AIOS_VERSION=2.1.4
|
|
234
234
|
|
|
235
235
|
# --------------------------------------------
|
|
236
236
|
# Custom Configuration
|