@mctx-ai/mcp-dev 0.5.5 → 0.5.6
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 +79 -0
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
<img src="https://mctx.ai/brand/logo-black.png" width="120" alt="mctx" />
|
|
3
|
+
</div>
|
|
4
|
+
|
|
5
|
+
# @mctx-ai/mcp-dev
|
|
6
|
+
|
|
7
|
+
Dev server with hot reload for [@mctx-ai/mcp-server](https://www.npmjs.com/package/@mctx-ai/mcp-server).
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/@mctx-ai/mcp-dev)
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Quick Start
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm install -D @mctx-ai/mcp-dev
|
|
17
|
+
npx mctx-dev index.js
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Your server restarts automatically on file changes.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## What It Does
|
|
25
|
+
|
|
26
|
+
- **Hot reload** — watches your files and restarts on save
|
|
27
|
+
- **Request logging** — logs every MCP request and response to the console
|
|
28
|
+
- **Local testing** — serves your server over HTTP for use with any MCP client
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
npx mctx-dev <entry-file> [options]
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
**Options:**
|
|
39
|
+
|
|
40
|
+
| Flag | Description | Default |
|
|
41
|
+
| ----------------- | ----------------- | ------- |
|
|
42
|
+
| `--port <number>` | Port to listen on | `3000` |
|
|
43
|
+
| `-h, --help` | Show help message | |
|
|
44
|
+
|
|
45
|
+
**Environment Variables:**
|
|
46
|
+
|
|
47
|
+
| Variable | Description |
|
|
48
|
+
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
49
|
+
| `PORT` | Port to listen on (overridden by `--port`) |
|
|
50
|
+
| `MCTX_VERBOSE` | Set to `true` to pretty-print full JSON request and response bodies to stdout for every non-handshake MCP method call. Default (unset): compact one-line logs showing direction, status, and timing only. |
|
|
51
|
+
|
|
52
|
+
**Examples:**
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
# Start on default port 3000
|
|
56
|
+
npx mctx-dev index.js
|
|
57
|
+
|
|
58
|
+
# Start on a custom port
|
|
59
|
+
npx mctx-dev index.js --port 8080
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Visual Testing
|
|
65
|
+
|
|
66
|
+
Use [MCP Inspector](https://github.com/modelcontextprotocol/inspector) to test your server interactively in the browser while `mctx-dev` is running.
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Pairs With
|
|
71
|
+
|
|
72
|
+
This package is the dev companion to [@mctx-ai/mcp-server](https://www.npmjs.com/package/@mctx-ai/mcp-server) — the zero-dependency MCP framework.
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
<p align="center">
|
|
77
|
+
<a href="https://mctx.ai">mctx</a> · <a href="https://docs.mctx.ai">Docs</a> · <a href="https://github.com/mctx-ai/mcp-server">GitHub</a><br/>
|
|
78
|
+
MIT License
|
|
79
|
+
</p>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mctx-ai/mcp-dev",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.6",
|
|
4
4
|
"description": "Local development server for @mctx-ai/mcp-server with hot reload",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./src/cli.js",
|
|
@@ -40,6 +40,6 @@
|
|
|
40
40
|
"provenance": true
|
|
41
41
|
},
|
|
42
42
|
"peerDependencies": {
|
|
43
|
-
"@mctx-ai/mcp-server": "0.6.
|
|
43
|
+
"@mctx-ai/mcp-server": "0.6.1"
|
|
44
44
|
}
|
|
45
45
|
}
|