@voxslopuli/moveit-mcp 0.1.1 → 0.1.2

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 +14 -14
  2. package/dist/index.js +2 -2
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -42,13 +42,13 @@ npm run build
42
42
 
43
43
  All configuration is via environment variables (see `.env.example`):
44
44
 
45
- | Variable | Required | Default | Description |
46
- | -------------------------------- | -------- | ------- | ------------------------------------------------------------------------------- |
47
- | `MOVEIT_BASE_URL` | yes | — | Web Admin base URL, **including the `/webadmin` suffix** |
48
- | `MOVEIT_USERNAME` | yes | — | MOVEit account username |
49
- | `MOVEIT_PASSWORD` | yes | — | MOVEit account password |
50
- | `MOVEIT_SERVER_HOST` | no | — | Server hostname sent in the token request when different from the base URL host |
51
- | `MOVEIT_TLS_REJECT_UNAUTHORIZED` | no | `true` | Set `"false"` to accept self-signed certificates |
45
+ | Variable | Required | Default | Description |
46
+ | -------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
47
+ | `MOVEIT_BASE_URL` | yes | — | Server root **without** `/api/v1` — e.g. `https://moveit.example.com` (API at host root) or `https://host/webadmin` (Web Admin-served). A trailing `/api/v1` is tolerated and stripped. |
48
+ | `MOVEIT_USERNAME` | yes | — | MOVEit account username |
49
+ | `MOVEIT_PASSWORD` | yes | — | MOVEit account password |
50
+ | `MOVEIT_SERVER_HOST` | no | — | Server hostname sent in the token request when different from the base URL host |
51
+ | `MOVEIT_TLS_REJECT_UNAUTHORIZED` | no | `true` | Set `"false"` to accept self-signed certificates |
52
52
 
53
53
  Missing required variables fail startup with a list of what is missing.
54
54
 
@@ -75,7 +75,7 @@ Add the server to `~/.config/opencode/opencode.json` (global) or `.opencode/open
75
75
  "type": "local",
76
76
  "command": ["npx", "-y", "@voxslopuli/moveit-mcp"],
77
77
  "environment": {
78
- "MOVEIT_BASE_URL": "https://moveit.example.com/webadmin",
78
+ "MOVEIT_BASE_URL": "https://moveit.example.com",
79
79
  "MOVEIT_USERNAME": "svc-account",
80
80
  "MOVEIT_PASSWORD": "changeme",
81
81
  "MOVEIT_TLS_REJECT_UNAUTHORIZED": "true"
@@ -99,7 +99,7 @@ Verify the connection with `opencode mcp list`. Set `"disabled": true` on a serv
99
99
  "command": "npx",
100
100
  "args": ["-y", "@voxslopuli/moveit-mcp"],
101
101
  "env": {
102
- "MOVEIT_BASE_URL": "https://moveit.example.com/webadmin",
102
+ "MOVEIT_BASE_URL": "https://moveit.example.com",
103
103
  "MOVEIT_USERNAME": "svc-account",
104
104
  "MOVEIT_PASSWORD": "changeme",
105
105
  "MOVEIT_TLS_REJECT_UNAUTHORIZED": "true"
@@ -118,7 +118,7 @@ Generic MCP client — any client that supports `mcpServers`:
118
118
  "command": "npx",
119
119
  "args": ["-y", "@voxslopuli/moveit-mcp"],
120
120
  "env": {
121
- "MOVEIT_BASE_URL": "https://moveit.example.com/webadmin",
121
+ "MOVEIT_BASE_URL": "https://moveit.example.com",
122
122
  "MOVEIT_USERNAME": "svc-account",
123
123
  "MOVEIT_PASSWORD": "changeme",
124
124
  "MOVEIT_SERVER_HOST": "",
@@ -129,7 +129,7 @@ Generic MCP client — any client that supports `mcpServers`:
129
129
  }
130
130
  ```
131
131
 
132
- > **`MOVEIT_BASE_URL` must include the `/webadmin` suffix** — the REST API lives under `https://<host>/webadmin/api/v1/`. A bare host URL like `https://moveit.example.com` will fail authentication.
132
+ > **`MOVEIT_BASE_URL` is the server root WITHOUT `/api/v1`** — deployments serve the API at different roots: some at `https://<host>/api/v1` (set `https://moveit.cnyric.org`), others under Web Admin at `https://<host>/webadmin/api/v1` (set `https://host/webadmin`). A trailing `/api/v1` is tolerated and stripped automatically.
133
133
 
134
134
  ## Tool reference
135
135
 
@@ -220,7 +220,7 @@ Pagination tools accept `page`, `perPage`, `fields`, and (where noted) a `name`/
220
220
 
221
221
  ### Reports
222
222
 
223
- All report tools take `predicate` (required), optional `orderBy`, optional `maxCount` (positive integer, max 10000).
223
+ All report tools take `predicate` (required), optional `orderBy`, optional `maxCount` (positive integer, max 10000). MOVEit accepts single-quoted strings in predicates, e.g. `Status=in=('Success','Failure')`, which is convenient when embedding in JSON bodies.
224
224
 
225
225
  | Tool | Input | Description |
226
226
  | ----------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
@@ -243,7 +243,7 @@ Example:
243
243
  - Combining: `;` or `and` for AND, `,` or `or` for OR.
244
244
  - Operators: `==`, `!=`, `=lt=` (`<`), `=le=` (`<=`), `=gt=` (`>`), `=ge=` (`>=`), `=in=`, `=out=`, `=like=`.
245
245
  - `=like=` supports `%` (any string) and `_` (any single character) wildcards.
246
- - String values are quoted; `=in=`/`=out=` take a parenthesized, comma-separated list of quoted values, e.g. `Status=in=("Success","Failure")`.
246
+ - String values are quoted; `=in=`/`=out=` take a parenthesized, comma-separated list of quoted values, e.g. `Status=in=("Success","Failure")`. MOVEit also accepts single quotes in predicates, e.g. `Status=in=('Success','Failure')`, which is convenient when embedding the predicate in a JSON body.
247
247
  - A leading `!` in `orderBy` values sorts descending (`!LogTime` = newest first).
248
248
 
249
249
  ## Out of scope (v1)
@@ -256,7 +256,7 @@ Example:
256
256
  ## Troubleshooting
257
257
 
258
258
  - **Missing environment variables** — startup fails with a list naming exactly which required variables are missing.
259
- - **401 loops** — usually wrong credentials, or `MOVEIT_BASE_URL` missing the `/webadmin` suffix while `MOVEIT_SERVER_HOST` diverges from the base URL host. Verify all three.
259
+ - **401 loops** — usually wrong credentials, or `MOVEIT_BASE_URL` pointing at the wrong root (bare host for a Web Admin-served deployment, or `/webadmin` where the API lives at the host root) while `MOVEIT_SERVER_HOST` diverges from the base URL host. Verify all three.
260
260
  - **Self-signed certificate errors** — set `MOVEIT_TLS_REJECT_UNAUTHORIZED=false` (non-production only).
261
261
  - **HTTP 422 on reports** — invalid `page`/`perPage` combinations or out-of-range `maxCount`; both must be positive integers (`maxCount` ≤ 10000).
262
262
 
package/dist/index.js CHANGED
@@ -9,7 +9,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
9
9
  // package.json
10
10
  var package_default = {
11
11
  name: "@voxslopuli/moveit-mcp",
12
- version: "0.1.1",
12
+ version: "0.1.2",
13
13
  type: "module",
14
14
  engines: {
15
15
  node: ">=20"
@@ -218,7 +218,7 @@ function loadConfig(env) {
218
218
  );
219
219
  const tlsRaw = env.MOVEIT_TLS_REJECT_UNAUTHORIZED;
220
220
  return {
221
- baseUrl: baseUrl.replace(/\/+$/, ""),
221
+ baseUrl: baseUrl.replace(/\/+$/, "").replace(/\/api\/v1$/i, "").replace(/\/+$/, ""),
222
222
  username,
223
223
  password,
224
224
  serverHost: env.MOVEIT_SERVER_HOST,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@voxslopuli/moveit-mcp",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "type": "module",
5
5
  "engines": {
6
6
  "node": ">=20"