@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.
- package/README.md +14 -14
- package/dist/index.js +2 -2
- 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 | — |
|
|
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
|
|
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
|
|
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
|
|
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`
|
|
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`
|
|
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.
|
|
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,
|