@modeltoolsprotocol/mtpcli 1.1.1 → 1.3.0
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.
- package/README.md +8 -8
- package/dist/index.js +459 -698
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# mtpcli
|
|
2
2
|
|
|
3
|
-
The command-line interface for the [Model Tools Protocol](https://github.com/modeltoolsprotocol/modeltoolsprotocol) (MTP). Discover, authenticate, and bridge tools that implement the `--describe` convention.
|
|
3
|
+
The command-line interface for the [Model Tools Protocol](https://github.com/modeltoolsprotocol/modeltoolsprotocol) (MTP). Discover, authenticate, and bridge tools that implement the `--mtp-describe` convention.
|
|
4
4
|
|
|
5
|
-
CLI tools are composable but not LLM-discoverable. MCP tools are discoverable but not composable. MTP bridges the gap with a single `--describe` flag. **mtpcli** turns any `--describe` CLI into an MCP server, turns any MCP server into a composable CLI, and handles discovery, auth, and validation along the way. See the [protocol README](https://github.com/modeltoolsprotocol/modeltoolsprotocol) for the full rationale.
|
|
5
|
+
CLI tools are composable but not LLM-discoverable. MCP tools are discoverable but not composable. MTP bridges the gap with a single `--mtp-describe` flag. **mtpcli** turns any `--mtp-describe` CLI into an MCP server, turns any MCP server into a composable CLI, and handles discovery, auth, and validation along the way. See the [protocol README](https://github.com/modeltoolsprotocol/modeltoolsprotocol) for the full rationale.
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
@@ -14,7 +14,7 @@ npm install -g @modeltoolsprotocol/mtpcli
|
|
|
14
14
|
|
|
15
15
|
### Serve CLI tools over MCP
|
|
16
16
|
|
|
17
|
-
Any CLI that supports `--describe` becomes an MCP server:
|
|
17
|
+
Any CLI that supports `--mtp-describe` becomes an MCP server:
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
$ mtpcli serve --tool atlasctl --tool mytool
|
|
@@ -27,7 +27,7 @@ mtpcli serve: serving 6 tool(s) from 2 CLI tool(s)
|
|
|
27
27
|
...
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
Drop it into your Claude Desktop config and it works like any other MCP server. The bridge reads `--describe`, translates commands to MCP tools, and shells out to the real CLI when the host calls a tool.
|
|
30
|
+
Drop it into your Claude Desktop config and it works like any other MCP server. The bridge reads `--mtp-describe`, translates commands to MCP tools, and shells out to the real CLI when the host calls a tool.
|
|
31
31
|
|
|
32
32
|
### Wrap an MCP server as a CLI
|
|
33
33
|
|
|
@@ -35,7 +35,7 @@ Atlassian ships an MCP server at `mcp.atlassian.com`. With `mtpcli wrap`, it's a
|
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
37
|
# Discover what tools the server offers
|
|
38
|
-
$ mtpcli wrap --url "https://mcp.atlassian.com/v1/mcp" --describe
|
|
38
|
+
$ mtpcli wrap --url "https://mcp.atlassian.com/v1/mcp" --mtp-describe
|
|
39
39
|
|
|
40
40
|
# Fetch a Confluence page
|
|
41
41
|
$ mtpcli wrap --url "https://mcp.atlassian.com/v1/mcp" \
|
|
@@ -47,7 +47,7 @@ $ mtpcli wrap --url "https://mcp.atlassian.com/v1/mcp" \
|
|
|
47
47
|
| jq -r '.body'
|
|
48
48
|
|
|
49
49
|
# Works with stdio servers too
|
|
50
|
-
$ mtpcli wrap --server "npx @mcp/server-github" --describe
|
|
50
|
+
$ mtpcli wrap --server "npx @mcp/server-github" --mtp-describe
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
The 2,500+ MCP servers people have built? They're all CLI tools now. Pipe their output, use them in scripts, compose them with other tools.
|
|
@@ -86,7 +86,7 @@ mtpcli auth logout mytool
|
|
|
86
86
|
|
|
87
87
|
See [AUTH.md](AUTH.md) for details on token storage, usage patterns, and bridge integration.
|
|
88
88
|
|
|
89
|
-
### Validate a tool's --describe output
|
|
89
|
+
### Validate a tool's --mtp-describe output
|
|
90
90
|
|
|
91
91
|
```bash
|
|
92
92
|
# Validate a tool against the MTP spec
|
|
@@ -116,7 +116,7 @@ mtpcli completions fish mytool | source
|
|
|
116
116
|
|
|
117
117
|
```bash
|
|
118
118
|
# mtpcli is itself an MTP-compliant tool
|
|
119
|
-
mtpcli --describe
|
|
119
|
+
mtpcli --mtp-describe
|
|
120
120
|
```
|
|
121
121
|
|
|
122
122
|
## Development
|