Skip to content

Commit e6852bc

Browse files
authored
docs(mcp): record the live Cursor and OpenCode checks (#2268)
The Cursor section said "Not verified live." and the OpenCode section recorded runs up to OpenCode 2.0.18. Cursor 3.27.22 and OpenCode 2.2.5, both on Linux, were connected to a local Studio with the token written into the Authorization header of their user-level settings files (~/.cursor/mcp.json, and ~/.config/opencode/opencode.json with mcp.servers and oauth: false), and each called list_connections, inspect_schema and run_read_query, each answered. Both sections now record those runs, and say that the environment variable form their snippets show was not part of them. Tests in tests/unit/mcp-documentation.test.ts pin the new lines.
1 parent cb7b261 commit e6852bc

2 files changed

Lines changed: 19 additions & 1 deletion

File tree

‎docs/MCP.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -499,7 +499,8 @@ bearer_token_env_var = "LIBREDB_MCP_TOKEN"
499499

500500
### Cursor
501501

502-
Not verified live.
502+
Verified live on 2026-11-06 with Cursor 3.27.22 on Linux.
503+
That run, against a local Studio, had the server in `~/.cursor/mcp.json` with the token written into its `Authorization` header rather than read through `${env:LIBREDB_MCP_TOKEN}`, and Cursor called `list_connections`, `inspect_schema` and `run_read_query`, each answered.
503504

504505
In `.cursor/mcp.json`:
505506

@@ -575,6 +576,8 @@ Do not commit a settings file that holds a token.
575576
### OpenCode
576577

577578
Verified live on 2026-09-26 with OpenCode 1.18.31, 1.18.32 and 2.0.18, on Linux and Windows.
579+
Verified live on 2026-11-06 with OpenCode 2.2.5 on Linux.
580+
That run, against a local Studio, had the server under `mcp.servers` with `oauth: false` in `~/.config/opencode/opencode.json` and the token written into its `Authorization` header rather than read through `{env:LIBREDB_MCP_TOKEN}`, and OpenCode called `list_connections`, `inspect_schema` and `run_read_query`, each answered.
578581

579582
In `opencode.json`, as a remote server under `mcp.servers`, where OpenCode 2 looks for servers and OpenCode 1 reads them too ([OpenCode's MCP servers page](https://opencode.ai/docs/mcp-servers), and [the OpenCode 2 page](https://opencode.ai/v2/docs/mcp-servers)); `oauth: false` turns off the OAuth sign-in OpenCode would otherwise attempt, and `{env:...}` reads the token from the environment:
580583

‎tests/unit/mcp-documentation.test.ts‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -460,6 +460,21 @@ describe("docs/MCP.md", () => {
460460
for (const section of sections) expect(section).toMatch(/Verified live on \S+ with |Not verified live\./);
461461
});
462462

463+
test("records the live Cursor run, and that the ${env:...} form was not part of it", () => {
464+
const cursor = MCP_DOC.split(/^### /m).find((section) => section.startsWith("Cursor\n"));
465+
expect(cursor).toContain(
466+
"Verified live on 2026-11-06 with Cursor 3.27.22 on Linux.\nThat run, against a local Studio, had the server in `~/.cursor/mcp.json` with the token written into its `Authorization` header rather than read through `${env:LIBREDB_MCP_TOKEN}`, and Cursor called `list_connections`, `inspect_schema` and `run_read_query`, each answered.\n",
467+
);
468+
expect(cursor).not.toContain("Not verified live.");
469+
});
470+
471+
test("records the live OpenCode 2.2.5 run, and that the {env:...} form was not part of it", () => {
472+
const opencode = MCP_DOC.split(/^### /m).find((section) => section.startsWith("OpenCode\n"));
473+
expect(opencode).toContain(
474+
"Verified live on 2026-11-06 with OpenCode 2.2.5 on Linux.\nThat run, against a local Studio, had the server under `mcp.servers` with `oauth: false` in `~/.config/opencode/opencode.json` and the token written into its `Authorization` header rather than read through `{env:LIBREDB_MCP_TOKEN}`, and OpenCode called `list_connections`, `inspect_schema` and `run_read_query`, each answered.\n",
475+
);
476+
});
477+
463478
test("mentions a batch only in the line that says batches are refused", () => {
464479
expect(MCP_DOC.split("\n").filter((line) => /batch/i.test(line))).toEqual([
465480
"- JSON-RPC batches are refused: a request body that is a JSON array gets 400 and `-32600`.",

0 commit comments

Comments
 (0)