@lumibase/mcp-server 0.25.0 → 1.0.0-rc.1
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 +73 -0
- package/package.json +17 -3
package/README.md
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# `@lumibase/mcp-server`
|
|
2
|
+
|
|
3
|
+
Stdio [Model Context Protocol](https://modelcontextprotocol.io) server for [LumiBase](https://lumibase.dev). Lets AI assistants (Claude Code, Cursor, Windsurf, …) manage collections, fields, items, editorial workflow, releases, insights, and more against a running CMS over REST.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
npm install -g @lumibase/mcp-server
|
|
7
|
+
# or run without installing:
|
|
8
|
+
npx @lumibase/mcp-server
|
|
9
|
+
# binary name:
|
|
10
|
+
lumibase-mcp
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Configure
|
|
14
|
+
|
|
15
|
+
Point the server at your CMS with environment variables:
|
|
16
|
+
|
|
17
|
+
| Variable | Required | Example |
|
|
18
|
+
| --- | --- | --- |
|
|
19
|
+
| `LUMIBASE_URL` | Yes | `https://api.mysite.lumibase.dev` or `http://localhost:1989` |
|
|
20
|
+
| `LUMIBASE_SITE_ID` | Yes | `site_abc123` |
|
|
21
|
+
| `LUMIBASE_TOKEN` | Yes | Bearer token with the roles you want the agent to inherit |
|
|
22
|
+
|
|
23
|
+
Example MCP client config:
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"mcpServers": {
|
|
28
|
+
"lumibase": {
|
|
29
|
+
"command": "npx",
|
|
30
|
+
"args": ["-y", "@lumibase/mcp-server"],
|
|
31
|
+
"env": {
|
|
32
|
+
"LUMIBASE_URL": "https://api.mysite.lumibase.dev",
|
|
33
|
+
"LUMIBASE_SITE_ID": "site_abc123",
|
|
34
|
+
"LUMIBASE_TOKEN": "<token>"
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
A ready-made snippet lives in the monorepo at [`docs/en/agent-setup/mcp-config.json`](https://github.com/khuepm/lumibase/blob/main/docs/en/agent-setup/mcp-config.json).
|
|
42
|
+
|
|
43
|
+
## What tools are available
|
|
44
|
+
|
|
45
|
+
Fixed CRUD + read-only groups registered by the stdio server, including:
|
|
46
|
+
|
|
47
|
+
- **Collections / fields / items** — list, get, create, update, delete, schema diff/apply
|
|
48
|
+
- **Insights** — dashboards, panels, ad-hoc aggregate queries (read-only)
|
|
49
|
+
- **Editorial** — reviews, approve/reject
|
|
50
|
+
- **Releases** — create, update, publish
|
|
51
|
+
- **Deployments** — read-only targets, deployments, logs
|
|
52
|
+
- **Shares, translation memory, presets, flows, site**
|
|
53
|
+
|
|
54
|
+
The token's roles are the permission floor: the MCP client can never do more than that same token can through the REST API.
|
|
55
|
+
|
|
56
|
+
> LumiBase also exposes a **governed HTTP MCP endpoint** at `POST /api/v1/mcp` inside the CMS (feature-flagged). That path runs through the agent harness (HITL, autonomy, veto). This package is the **standalone stdio** server for local editor integration — a passthrough, not the harness.
|
|
57
|
+
|
|
58
|
+
## Docs
|
|
59
|
+
|
|
60
|
+
- [MCP overview](https://docs.lumibase.dev/en/mcp/)
|
|
61
|
+
- [Agent setup](https://docs.lumibase.dev/en/agent-setup/)
|
|
62
|
+
|
|
63
|
+
## Related packages
|
|
64
|
+
|
|
65
|
+
| Package | Role |
|
|
66
|
+
| --- | --- |
|
|
67
|
+
| [`@lumibase/sdk`](https://www.npmjs.com/package/@lumibase/sdk) | Typed REST / realtime client |
|
|
68
|
+
| [`@lumibase/extension-sdk`](https://www.npmjs.com/package/@lumibase/extension-sdk) | Author extensions |
|
|
69
|
+
| [`@lumibase/contracts`](https://www.npmjs.com/package/@lumibase/contracts) | Shared Zod schemas / policy & field DSLs |
|
|
70
|
+
|
|
71
|
+
## License
|
|
72
|
+
|
|
73
|
+
Apache-2.0 — part of the [LumiBase](https://github.com/khuepm/lumibase) monorepo.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lumibase/mcp-server",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "1.0.0-rc.1",
|
|
4
4
|
"description": "LumiBase MCP server — lets AI assistants manage the full LumiBase Content OS: collections, fields, items, relations, RBAC (roles/policies/permissions/API keys), users & teams, intents, flows, webhooks, translations & translation memory, search, media & transform presets, read-only insights, presets, editorial workflow, content releases, share links, read-only deployments, extensions, and site administration.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"type": "module",
|
|
@@ -30,10 +30,10 @@
|
|
|
30
30
|
"zod": "^4.4.3"
|
|
31
31
|
},
|
|
32
32
|
"devDependencies": {
|
|
33
|
-
"@types/node": "^26.
|
|
33
|
+
"@types/node": "^26.4.0",
|
|
34
34
|
"tsup": "^8.5.1",
|
|
35
35
|
"typescript": "^5.6.2",
|
|
36
|
-
"vitest": "^4.1.
|
|
36
|
+
"vitest": "^4.1.11"
|
|
37
37
|
},
|
|
38
38
|
"files": [
|
|
39
39
|
"dist"
|
|
@@ -41,6 +41,20 @@
|
|
|
41
41
|
"engines": {
|
|
42
42
|
"node": ">=18"
|
|
43
43
|
},
|
|
44
|
+
"homepage": "https://docs.lumibase.dev",
|
|
45
|
+
"bugs": {
|
|
46
|
+
"url": "https://github.com/khuepm/lumibase/issues"
|
|
47
|
+
},
|
|
48
|
+
"keywords": [
|
|
49
|
+
"lumibase",
|
|
50
|
+
"cms",
|
|
51
|
+
"mcp",
|
|
52
|
+
"model-context-protocol",
|
|
53
|
+
"ai",
|
|
54
|
+
"claude",
|
|
55
|
+
"cursor",
|
|
56
|
+
"stdio"
|
|
57
|
+
],
|
|
44
58
|
"scripts": {
|
|
45
59
|
"build": "tsup src/index.ts --format cjs,esm --dts --clean",
|
|
46
60
|
"dev": "tsup src/index.ts --format cjs --watch",
|