@mcp-use/cli 1.0.15 → 1.0.19

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 (4) hide show
  1. package/LICENSE +21 -0
  2. package/dist/cli.js +6081 -2164
  3. package/package.json +14 -4
  4. package/readme.md +80 -13
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mcp-use/cli",
3
- "version": "1.0.15",
3
+ "version": "1.0.19",
4
4
  "license": "MIT",
5
5
  "description": "CLI for interacting with Model Context Protocol servers via natural language",
6
6
  "keywords": [
@@ -10,10 +10,14 @@
10
10
  "ai"
11
11
  ],
12
12
  "author": "Pietro",
13
+ "homepage": "https://mcp-use.com",
13
14
  "repository": {
14
15
  "type": "git",
15
16
  "url": "https://github.com/mcp-use/mcp-use-cli"
16
17
  },
18
+ "bugs": {
19
+ "url": "https://github.com/mcp-use/mcp-use-cli/issues"
20
+ },
17
21
  "bin": {
18
22
  "mcp-use": "dist/cli.js"
19
23
  },
@@ -49,12 +53,13 @@
49
53
  "@langchain/ollama": "^0.2.3",
50
54
  "@langchain/xai": "^0.0.3",
51
55
  "@modelcontextprotocol/sdk": "^1.13.2",
56
+ "@scarf/scarf": "^1.4.0",
52
57
  "cli-spinners": "^3.2.0",
53
58
  "dotenv": "^16.5.0",
54
59
  "ink": "^5.2.1",
55
- "ink-big-text": "^2.0.0",
56
60
  "ink-gradient": "^3.0.0",
57
- "mcp-use": "^0.1.1",
61
+ "ink-link": "^4.1.0",
62
+ "mcp-use": "^0.1.2",
58
63
  "meow": "^11.0.0",
59
64
  "react": "^18.2.0"
60
65
  },
@@ -72,5 +77,10 @@
72
77
  "typescript": "^5.0.3",
73
78
  "typescript-eslint": "^8.35.0"
74
79
  },
75
- "prettier": "@vdemedes/prettier-config"
80
+ "prettier": "@vdemedes/prettier-config",
81
+ "scarfSettings": {
82
+ "enabled": true,
83
+ "defaultOptIn": true,
84
+ "allowTopLevel": true
85
+ }
76
86
  }
package/readme.md CHANGED
@@ -1,8 +1,15 @@
1
1
  <div align="center">
2
- <img src="static/terminal.png" alt="Terminal" />
2
+ <img src="static/readme.png" alt="Terminal" />
3
3
  </div>
4
4
 
5
- A CLI tool for interacting with Model Context Protocol (MCP) servers using natural language. Built with [mcp-use](https://github.com/mcp-use/mcp-use-ts).
5
+ # Open Source and Open Model CLI for MCP
6
+
7
+ A CLI tool for interacting with Model Context Protocol (MCP) servers using natural language.
8
+
9
+ ## Built with [mcp-use](https://mcp-use.com), build your own MCP application with our SDKs:
10
+
11
+ <h4><strong>Python</strong> <a href="https://github.com/mcp-use/mcp-use"><img src="static/python.png" alt="Python" height="24" style="vertical-align: middle; margin-right: 4px;"/>mcp-use/mcp-use</a></h4>
12
+ <h4><strong>Typescript</strong> <a href="https://github.com/mcp-use/mcp-use-ts"><img src="static/typescript.png" alt="TypeScript" height="20" style="vertical-align: middle; margin-right: 4px;"/>mcp-use/mcp-use-ts</a></h4>
6
13
 
7
14
  ## Features
8
15
 
@@ -97,7 +104,7 @@ This CLI is a client for [Model Context Protocol (MCP)](https://github.com/mcp-u
97
104
  You can manage servers with the `/server` commands:
98
105
 
99
106
  ```bash
100
- # Interactively add a new server configuration
107
+ # Add a new server configuration by pasting its JSON definition
101
108
  /server add
102
109
 
103
110
  # List configured servers
@@ -110,22 +117,39 @@ You can manage servers with the `/server` commands:
110
117
  /server disconnect <server-name>
111
118
  ```
112
119
 
113
- When you add a server, you'll be prompted for its configuration details, such as the command to run it. Here is an example of what a server configuration for a filesystem tool looks like:
120
+ When you add a server, you'll be prompted for its JSON configuration. Here are examples for local and remote servers:
121
+
122
+ **Local Server Example (e.g., a filesystem tool):**
123
+
124
+ ```json
125
+ {
126
+ "mcpServers": {
127
+ "filesystem-tool": {
128
+ "command": "npx",
129
+ "args": [
130
+ "-y",
131
+ "@modelcontextprotocol/server-filesystem",
132
+ "/path/to/your/project"
133
+ ],
134
+ "env": {}
135
+ }
136
+ }
137
+ }
138
+ ```
139
+
140
+ **Remote Server Example (e.g., an SSE endpoint):**
114
141
 
115
142
  ```json
116
143
  {
117
- "filesystem-tool": {
118
- "command": "npx",
119
- "args": [
120
- "-y",
121
- "@modelcontextprotocol/server-filesystem",
122
- "/path/to/your/project"
123
- ],
124
- "env": {}
144
+ "mcpServers": {
145
+ "remote-tool": {
146
+ "url": "http://127.0.0.1:8000/sse"
147
+ }
125
148
  }
126
149
  }
127
150
  ```
128
- This configuration would be created interactively by running `/server add` and answering the prompts.
151
+
152
+ This configuration would be pasted directly into the CLI after running `/server add`.
129
153
 
130
154
  ## Slash Commands
131
155
 
@@ -178,6 +202,49 @@ This CLI uses:
178
202
  - **LLM**: Your choice of 12+ providers
179
203
  - **Transport**: Direct TypeScript integration (no API layer)
180
204
 
205
+ ## Privacy & Telemetry
206
+
207
+ This package uses [Scarf](https://scarf.sh) to collect basic installation analytics to help us understand how the package is being used. This data helps us improve the tool and prioritize features.
208
+
209
+ ### What data is collected?
210
+
211
+ Scarf collects:
212
+
213
+ - Operating system information
214
+ - IP address (used only for company lookup, not stored)
215
+ - Limited dependency tree information (hashed for privacy)
216
+
217
+ **No personally identifying information is stored.**
218
+
219
+ ### How to disable telemetry
220
+
221
+ You can opt out of analytics in several ways:
222
+
223
+ **Option 1: Environment variable**
224
+
225
+ ```bash
226
+ export SCARF_ANALYTICS=false
227
+ ```
228
+
229
+ **Option 2: Standard Do Not Track**
230
+
231
+ ```bash
232
+ export DO_NOT_TRACK=1
233
+ ```
234
+
235
+ **Option 3: For package maintainers**
236
+ If you distribute a package that depends on this CLI, you can disable analytics for all your downstream users by adding this to your `package.json`:
237
+
238
+ ```json
239
+ {
240
+ "scarfSettings": {
241
+ "enabled": false
242
+ }
243
+ }
244
+ ```
245
+
246
+ For more information about Scarf and privacy, visit [scarf.sh](https://scarf.sh).
247
+
181
248
  ## License
182
249
 
183
250
  MIT