@littlebigbrain/mcp 0.2.3 → 0.2.4
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 -16
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,12 +1,10 @@
|
|
|
1
1
|
# @littlebigbrain/mcp
|
|
2
2
|
|
|
3
|
-
Eleven task-shaped MCP tools
|
|
4
|
-
brain graph from Claude, Cursor, Codex, or another MCP client.
|
|
3
|
+
Eleven task-shaped [MCP](https://modelcontextprotocol.io) tools that let Claude, Cursor, Codex, or any MCP client search, query, and write a [Little Big Brain](https://littlebigbrain.com) graph. Ships two ways: a hosted endpoint with OAuth sign-in, and a local stdio server.
|
|
5
4
|
|
|
6
|
-
## Hosted OAuth
|
|
5
|
+
## Hosted (OAuth) — recommended
|
|
7
6
|
|
|
8
|
-
|
|
9
|
-
stores a little big brain stack key:
|
|
7
|
+
The client opens WorkOS sign-in; your machine never stores a Little Big Brain key. Point it at your stack:
|
|
10
8
|
|
|
11
9
|
```json
|
|
12
10
|
{
|
|
@@ -18,7 +16,7 @@ stores a little big brain stack key:
|
|
|
18
16
|
}
|
|
19
17
|
```
|
|
20
18
|
|
|
21
|
-
Codex
|
|
19
|
+
Codex sends the URL as an OAuth `resource`, so use the origin plus a stack header instead:
|
|
22
20
|
|
|
23
21
|
```json
|
|
24
22
|
{
|
|
@@ -32,7 +30,9 @@ Codex Desktop should use the origin plus a stack header:
|
|
|
32
30
|
}
|
|
33
31
|
```
|
|
34
32
|
|
|
35
|
-
## Local stdio
|
|
33
|
+
## Local (stdio)
|
|
34
|
+
|
|
35
|
+
Run against any data-plane endpoint with a stack API key:
|
|
36
36
|
|
|
37
37
|
```json
|
|
38
38
|
{
|
|
@@ -49,7 +49,7 @@ Codex Desktop should use the origin plus a stack header:
|
|
|
49
49
|
}
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
-
Set `LBB_GRAPH` or `LBB_BRANCH`
|
|
52
|
+
Set `LBB_GRAPH` or `LBB_BRANCH` to target a scope other than `main`.
|
|
53
53
|
|
|
54
54
|
## Tools
|
|
55
55
|
|
|
@@ -67,24 +67,22 @@ Set `LBB_GRAPH` or `LBB_BRANCH` when the scope is not `main`.
|
|
|
67
67
|
| `lbb_configure` | ontology, schema, and inference rules |
|
|
68
68
|
| `lbb_index` | BM25, vector, and adjacency refresh |
|
|
69
69
|
|
|
70
|
-
Read tools return compact structured envelopes by default
|
|
71
|
-
`row_limit`, and returned cursors to page without silently truncating results.
|
|
72
|
-
Write tools derive idempotency keys unless you provide one.
|
|
70
|
+
Read tools return compact structured envelopes by default — use `detail`, `row_limit`, and returned cursors to page without silently truncating. Write tools derive an idempotency key unless you provide one.
|
|
73
71
|
|
|
74
72
|
## Embed the server
|
|
75
73
|
|
|
74
|
+
For self-hosting behind your own auth, the package also serves the tools over HTTP:
|
|
75
|
+
|
|
76
76
|
```ts
|
|
77
77
|
import { createMcpHttpServer } from "@littlebigbrain/mcp";
|
|
78
78
|
|
|
79
79
|
createMcpHttpServer({
|
|
80
80
|
baseUrl: "https://db.eu.littlebigbrain.com",
|
|
81
81
|
mcpPath: "/mcp",
|
|
82
|
-
allowedHosts: ["127.0.0.1", "localhost", "::1"
|
|
82
|
+
allowedHosts: ["127.0.0.1", "localhost", "::1"],
|
|
83
83
|
}).listen(8080, "127.0.0.1");
|
|
84
84
|
```
|
|
85
85
|
|
|
86
|
-
The embedded
|
|
87
|
-
self-hosting behind your own auth. The hosted endpoint's OAuth/ownership layer
|
|
88
|
-
is served by the little big brain API.
|
|
86
|
+
The embedded server passes a key bearer to the data plane; the hosted endpoint's OAuth and ownership layer is served separately by the Little Big Brain API.
|
|
89
87
|
|
|
90
|
-
Full tool schemas and examples: [
|
|
88
|
+
Full tool schemas and examples: [docs.littlebigbrain.com/sdks/mcp](https://docs.littlebigbrain.com/sdks/mcp/).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@littlebigbrain/mcp",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.4",
|
|
4
4
|
"description": "MCP server for little big brain — graph and hybrid search tools for agents",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
@@ -52,7 +52,7 @@
|
|
|
52
52
|
"test:coverage": "npm run clean:test && tsc -p tsconfig.test.json && node --test --experimental-test-coverage --test-coverage-include=test-dist/*.js --test-coverage-exclude=test-dist/*.test.js --test-coverage-exclude=test-dist/stdio.js --test-coverage-exclude=test-dist/test-support.js --test-coverage-lines=90 --test-coverage-branches=70 --test-coverage-functions=85 \"test-dist/**/*.test.js\""
|
|
53
53
|
},
|
|
54
54
|
"dependencies": {
|
|
55
|
-
"@littlebigbrain/client": "^0.
|
|
55
|
+
"@littlebigbrain/client": "^0.6.0",
|
|
56
56
|
"@modelcontextprotocol/sdk": "^1",
|
|
57
57
|
"zod": "^3"
|
|
58
58
|
},
|