mcp-lazy 0.1.6 → 0.1.7

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.
Files changed (3) hide show
  1. package/README.md +28 -7
  2. package/docs/README.ko.md +35 -7
  3. package/package.json +4 -3
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
  ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚══════╝╚═╝ ╚═╝╚══════╝ ╚═╝
8
8
  </pre>
9
9
 
10
- # mcp-lazy
10
+ # mcp-lazy 🫠
11
11
 
12
12
  [한국어](./docs/README.ko.md)
13
13
 
@@ -15,20 +15,41 @@
15
15
 
16
16
  - MCP servers load all tool definitions into the context window at startup — even before you use them. With 5-10 servers, this can consume 30-50% of your context window. **mcp-lazy** proxies all your MCP servers through a single lightweight proxy that loads tools on-demand.
17
17
 
18
+ <center>
19
+
20
+ <br>
21
+
22
+ `82 tools exposed at startup`
23
+ ![Before mcp-lazy](./public/before.png)
24
+
25
+ 👇 `Just 2 with mcp-lazy`
26
+
27
+ ![After mcp-lazy](./public/after.png)
28
+
29
+ </center>
30
+
18
31
  <br>
19
32
 
20
33
  ## Quick Start
21
34
 
35
+ Pick one for your agent:
36
+
37
+ ```bash
38
+ npx mcp-lazy add --cursor # Cursor
39
+ npx mcp-lazy add --codex # Codex
40
+ npx mcp-lazy add --antigravity # Antigravity
41
+ npx mcp-lazy add --opencode # Opencode
42
+ npx mcp-lazy add --all # or all at once
43
+ ```
44
+
45
+ Then pre-build the tool cache (recommended):
46
+
22
47
  ```bash
23
- npx mcp-lazy add --cursor
24
- npx mcp-lazy add --codex
25
- npx mcp-lazy add --antigravity
26
- npx mcp-lazy add --all # or register all at once
27
- npx mcp-lazy init # pre-build tool cache (recommended)
48
+ npx mcp-lazy init
28
49
  ```
29
50
 
30
51
  - The `add` command reads your agent's existing MCP config, saves all server definitions to `~/.mcp-lazy/servers.json`, and replaces the agent config with only the mcp-lazy proxy entry.
31
- - Run `init` after `add` to pre-build the tool cache. Without it, the first agent session will be slower while mcp-lazy discovers tools from all servers.
52
+ - `init` pre-builds the tool cache so your first agent session starts instantly. Without it, the first session will be slightly slower while mcp-lazy discovers tools from all servers.
32
53
 
33
54
  > **Tip:** Installed a new MCP server? Just re-run `npx mcp-lazy add --<agent>` — no extra steps.
34
55
 
package/docs/README.ko.md CHANGED
@@ -1,4 +1,13 @@
1
- # mcp-lazy
1
+ <pre>
2
+ ███╗ ███╗ ██████╗██████╗ ██╗ █████╗ ███████╗██╗ ██╗
3
+ ████╗ ████║██╔════╝██╔══██╗ ██║ ██╔══██╗╚══███╔╝╚██╗ ██╔╝
4
+ ██╔████╔██║██║ ██████╔╝█████╗██║ ███████║ ███╔╝ ╚████╔╝
5
+ ██║╚██╔╝██║██║ ██╔═══╝ ╚════╝██║ ██╔══██║ ███╔╝ ╚██╔╝
6
+ ██║ ╚═╝ ██║╚██████╗██║ ███████╗██║ ██║███████╗ ██║
7
+ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚══════╝╚═╝ ╚═╝╚══════╝ ╚═╝
8
+ </pre>
9
+
10
+ # mcp-lazy 🫠
2
11
 
3
12
  [English](../README.md)
4
13
 
@@ -6,18 +15,37 @@
6
15
 
7
16
  - MCP 서버들은 시작할 때 모든 툴 정의를 컨텍스트 윈도우에 로딩합니다 — 사용하기도 전에요. 서버가 5~10개면 컨텍스트 윈도우의 30~50%를 차지할 수 있습니다. **mcp-lazy**는 모든 MCP 서버를 하나의 경량 프록시로 묶어서, 필요할 때만 툴을 로딩합니다.
8
17
 
18
+ <center>
19
+
20
+ `시작 시 82개 툴이 로딩됨`
21
+ ![Before mcp-lazy](../public/before.png)
22
+
23
+ 👇 `mcp-lazy 적용 후 단 2개`
24
+
25
+ ![After mcp-lazy](../public/after.png)
26
+
27
+ </center>
28
+
9
29
  ## 빠른 시작
10
30
 
31
+ 사용하는 에이전트에 맞게 하나를 선택하세요:
32
+
33
+ ```bash
34
+ npx mcp-lazy add --cursor # Cursor
35
+ npx mcp-lazy add --codex # Codex
36
+ npx mcp-lazy add --antigravity # Antigravity
37
+ npx mcp-lazy add --opencode # Opencode
38
+ npx mcp-lazy add --all # 또는 한번에 전부 등록
39
+ ```
40
+
41
+ 그 다음 툴 캐시를 사전 구축합니다 (권장):
42
+
11
43
  ```bash
12
- npx mcp-lazy add --cursor
13
- npx mcp-lazy add --codex
14
- npx mcp-lazy add --antigravity
15
- npx mcp-lazy add --all # 또는 한번에 전부 등록
16
- npx mcp-lazy init # 툴 캐시 사전 구축 (권장)
44
+ npx mcp-lazy init
17
45
  ```
18
46
 
19
47
  - `add` 명령어가 에이전트의 기존 MCP 설정을 읽어서 모든 서버 정의를 `~/.mcp-lazy/servers.json`에 저장하고, 에이전트 설정을 mcp-lazy 프록시 항목 하나로 교체합니다.
20
- - `add` 실행 후 `init`을 실행하면 툴 캐시를 사전 구축합니다. 실행하지 않으면 첫 에이전트 세션에서 서버 접속에 시간이 소요됩니다.
48
+ - `init`은 툴 캐시를 사전 구축하여 첫 에이전트 세션이 즉시 시작되도록 합니다. 실행하지 않으면 첫 세션에서 서버 접속에 시간이 소요됩니다.
21
49
 
22
50
  > **Tip:** 새로운 MCP 서버를 설치했다면 `npx mcp-lazy add --<agent>`를 다시 실행하세요 — 추가 작업 없이 반영됩니다.
23
51
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-lazy",
3
- "version": "0.1.6",
3
+ "version": "0.1.7",
4
4
  "description": "MCP lazy loading proxy for AI agents - reduce context window token usage by 90%+",
5
5
  "type": "module",
6
6
  "bin": {
@@ -38,14 +38,15 @@
38
38
  "dependencies": {
39
39
  "@modelcontextprotocol/sdk": "^1.12.1",
40
40
  "commander": "^13.1.0",
41
+ "mcp-lazy": "^0.1.6",
41
42
  "zod": "^3.24.0"
42
43
  },
43
44
  "devDependencies": {
45
+ "@types/node": "^22.0.0",
44
46
  "tsup": "^8.4.0",
45
47
  "tsx": "^4.19.0",
46
48
  "typescript": "^5.7.0",
47
- "vitest": "^3.1.0",
48
- "@types/node": "^22.0.0"
49
+ "vitest": "^3.1.0"
49
50
  },
50
51
  "engines": {
51
52
  "node": ">=18.0.0"