document-mcp 1.5.4 → 1.5.5
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 +36 -1
- package/dist/bin.js +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -56,6 +56,23 @@ Run the server directly — no install step needed:
|
|
|
56
56
|
npx document-mcp
|
|
57
57
|
```
|
|
58
58
|
|
|
59
|
+
The server uses **stdio transport** (runs as a local process). This is supported by Claude Code, Claude Desktop, Codex CLI, Codex Desktop, and OpenCode directly. Claude Web (claude.ai), Claude Mobile, and ChatGPT require a **remote HTTP** MCP server — see [Remote transport](#remote-transport-http) below.
|
|
60
|
+
|
|
61
|
+
### Compatibility
|
|
62
|
+
|
|
63
|
+
| Client | Transport | Direct support |
|
|
64
|
+
|---|---|---|
|
|
65
|
+
| Claude Code (CLI) | stdio | ✅ |
|
|
66
|
+
| Claude Code (plugin) | stdio | ✅ |
|
|
67
|
+
| Claude Desktop | stdio | ✅ |
|
|
68
|
+
| Codex CLI | stdio | ✅ |
|
|
69
|
+
| Codex Desktop | stdio | ✅ |
|
|
70
|
+
| OpenCode | stdio | ✅ |
|
|
71
|
+
| Claude Team/Enterprise (org) | stdio (per-machine) | ✅ via managed settings |
|
|
72
|
+
| Claude Web (claude.ai) | HTTP/SSE only | ❌ needs remote transport |
|
|
73
|
+
| Claude Mobile (iOS/Android) | HTTP/SSE only | ❌ needs remote transport |
|
|
74
|
+
| ChatGPT (web/desktop) | HTTP only | ❌ needs remote transport |
|
|
75
|
+
|
|
59
76
|
### Connecting from Claude Code
|
|
60
77
|
|
|
61
78
|
One-liner (adds the MCP server directly):
|
|
@@ -88,7 +105,9 @@ Run `/reload-plugins` to activate in an already-running session. In Claude Deskt
|
|
|
88
105
|
codex mcp add document-mcp -- npx -y document-mcp
|
|
89
106
|
```
|
|
90
107
|
|
|
91
|
-
Or
|
|
108
|
+
Or via the Codex Desktop app: **Settings → MCP Servers → + Add**.
|
|
109
|
+
|
|
110
|
+
Or add to `~/.codex/config.toml` manually:
|
|
92
111
|
|
|
93
112
|
```toml
|
|
94
113
|
[mcp_servers.document-mcp]
|
|
@@ -139,6 +158,22 @@ Or, for local development against a checkout of this repository rather than the
|
|
|
139
158
|
}
|
|
140
159
|
```
|
|
141
160
|
|
|
161
|
+
### Connecting from Claude Team/Enterprise (organization)
|
|
162
|
+
|
|
163
|
+
Organization admins can deploy MCP server configurations centrally via **server-managed settings** (Admin Settings → Claude Code → Managed settings in the claude.ai console). A `managed-settings.json` entry for document-mcp enforces the connection across all Claude Code users in the org — no per-user setup needed. Admins can also allow/block specific MCP servers via `allowedMcpServers`/`blockedMcpServers` in the same file.
|
|
164
|
+
|
|
165
|
+
### Remote transport (HTTP)
|
|
166
|
+
|
|
167
|
+
Claude Web, Claude Mobile, and ChatGPT only accept **remote** (HTTP/SSE) MCP servers — a local stdio process is not reachable from a browser or phone. To use document-mcp on those platforms, run it behind an HTTP transport:
|
|
168
|
+
|
|
169
|
+
```sh
|
|
170
|
+
npx document-mcp --transport http --port 3000
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
Then add the server URL (e.g., `https://your-host:3000/mcp`) as a connector in Claude Web (**claude.ai/customize/connectors**) or ChatGPT (**Settings → Connectors → Advanced → Enable Developer Mode → Create**). Use a tunnel (Cloudflare Tunnel, ngrok) or deploy to a server with TLS — both platforms require HTTPS.
|
|
174
|
+
|
|
175
|
+
> **Note:** the `--transport http` flag is not yet implemented. The server currently only supports stdio. Track this as a future capability — the MCP SDK supports SSE/streamable-http transports, so adding it is a matter of wiring the existing server to an HTTP listener.
|
|
176
|
+
|
|
142
177
|
### Development
|
|
143
178
|
|
|
144
179
|
Requires Node.js `>=20` and pnpm `11.6.0` (pinned via `packageManager` in `package.json`).
|
package/dist/bin.js
CHANGED
|
@@ -7,7 +7,7 @@ import { readFile, writeFile } from "node:fs/promises";
|
|
|
7
7
|
import { existsSync, readFileSync } from "node:fs";
|
|
8
8
|
import { basename, join } from "node:path";
|
|
9
9
|
//#region package.json
|
|
10
|
-
var version = "1.5.
|
|
10
|
+
var version = "1.5.5";
|
|
11
11
|
//#endregion
|
|
12
12
|
//#region src/io/document-input.ts
|
|
13
13
|
const EXTENSION_TO_FORMAT = {
|
package/dist/index.cjs
CHANGED
|
@@ -6,7 +6,7 @@ let node_fs_promises = require("node:fs/promises");
|
|
|
6
6
|
let node_fs = require("node:fs");
|
|
7
7
|
let node_path = require("node:path");
|
|
8
8
|
//#region package.json
|
|
9
|
-
var version = "1.5.
|
|
9
|
+
var version = "1.5.5";
|
|
10
10
|
//#endregion
|
|
11
11
|
//#region src/io/document-input.ts
|
|
12
12
|
const EXTENSION_TO_FORMAT = {
|
package/dist/index.js
CHANGED
|
@@ -5,7 +5,7 @@ import { readFile, writeFile } from "node:fs/promises";
|
|
|
5
5
|
import { existsSync, readFileSync } from "node:fs";
|
|
6
6
|
import { basename, join } from "node:path";
|
|
7
7
|
//#region package.json
|
|
8
|
-
var version = "1.5.
|
|
8
|
+
var version = "1.5.5";
|
|
9
9
|
//#endregion
|
|
10
10
|
//#region src/io/document-input.ts
|
|
11
11
|
const EXTENSION_TO_FORMAT = {
|
package/package.json
CHANGED