8000 docs(readme): mark the Cline MCP row tested by xerj-org · Pull Request #2300 · xerj-org/xerj · GitHub
[go: up one dir, main page]

Skip to content

docs(readme): mark the Cline MCP row tested - #2300

Merged
xerj-org merged 1 commit into
mainfrom
cursor/cline-mcp-readme-tested-b933
Oct 24, 2026
Merged

xerj-org merged 1 commit into
mainfrom
cursor/cline-mcp-readme-tested-b933

Conversation

@xerj-org
Copy link
Copy Markdown
Owner

What this changes, and why

The supported-agents table marked Cline untested and said only the OpenCode row had been run. That sentence is no longer true. Cline CLI 3.0.73 on Linux registered xerj mcp from the README's mcpServers block and xerj_search appeared in the tool list Cline handed the model.

The Cline row is now tested. The paragraph names the run: CLI 3.0.73, Linux, xerj v1.0.0-rc.98, 20 tools on that binary, one xerj_search call. It also says the IDE's MCP Servers > Configure button was not part of the run, and that the model turn was a local OpenAI-compatible stub because no provider key was available. The same facts are in the Chinese and Korean READMEs so they do not keep saying only OpenCode has been run.

The config block itself is unchanged. disabled and autoApprove were omitted and the CLI still connected; the note now says the CLI run did not need them.

Evidence

xerj --version
-> xerj v1.0.0-rc.98   # curl -fsSL https://xerj.org/get | sh

cline --version
-> 3.0.73

# ~/.cline/data/settings/cline_mcp_settings.json was the README block:
# command /home/ubuntu/.local/bin/xerj, args ["mcp"], env XERJ_URL=http://localhost:9200

cline config mcp
-> Configured MCP servers (.../cline_mcp_settings.json):
->   xerj [stdio]

xerj mcp --help
-> proxies 20 tools — xerj_search, ... xerj_hub_ask
-> (xerj_def is not i
8000
n this list; it landed after the v1.0.0-rc.98 tag)

# cline -P openai-compatible -m stub-model, stub at http://127.0.0.1:8765/v1
# first model request tool list included xerj__xerj_search among 20 xerj__* tools
# Cline executed xerj__xerj_search {query: checkout_error, size: 1}
# tool result: ax-docs hit checkout.rs line 1, code "fn checkout_error()", isError false
# run_result finishReason=completed iterations=2

A real cline process with the default Cline provider, and no API key, exited before spawning xerj (strace showed no exec of the binary; the error was Unauthorized). The successful run used the same CLI and the same settings file, with the model replaced by the local stub so Cline would issue the tool call.

Checks

  • cargo fmt --all (CI runs rustfmt --check and clippy -D warnings)
  • Scoped release build of the crates touched: cargo build --release -j 32 -p <crate>
  • cargo test -p <crate> passes (cargo check is not sufficient — test code is interleaved with production code)
  • ES-YAML conformance suite at 0 failed (cargo run --release -p es-yaml-runner -- --dir tests/es-compat-yaml/yaml), or: not applicable because this change is docs/landing-only
  • New ES-compatible behaviour has a matching YAML case under engine/tests/es-compat-yaml/yaml/
  • Docs updated if user-visible behaviour changed
  • For non-trivial changes: the applicable audit in docs/CONTRIBUTION_REVIEW.md
  • For non-trivial changes: if this PR changes an operational document or runnable recipe, complete the operational audit in docs/CONTRIBUTION_REVIEW.md. Record a negative control that exits non-zero with no artifact extracted, installed, published, or served. Keep verification and its action in one block; rerun the control with the failing exit discarded and with the next documented block appended, and require that neither reaches an artifact or unsafe/privileged path. List tested variants and unsupported variants separately, and verify every publication copy. Otherwise mark this item N/A with a reason.

The recipe block was not edited. It was executed as written: the mcpServers JSON in the README, with the absolute path substituted, placed at the Cline path in the table. A negative control was the first cline invocation with no provider key: exit 1, error Unauthorized, and strace showed xerj was not executed. The IDE Configure path and the VS Code extension were not run.

Publication copies updated: README.md, README.zh-CN.md, README.ko.md. README.ja-JP.md, README.es.md, and README.ar.md do not carry this table.

Not run: cargo fmt, scoped release build, cargo test, and a new ES-YAML case. This diff is README prose only. The ES-YAML gate is not applicable.

Provenance

  • Written by: AI agent (Grok), in a cloud session on this repository. No human reviewed the diff before the PR was opened.
  • Verified (commands run, output observed): curl -fsSL https://xerj.org/get | sh installed xerj v1.0.0-rc.98 to ~/.local/bin/xerj. npm install -g --prefix ~/.local cline installed Cline CLI 3.0.73. xerj --insecure --data-dir ~/xerj-data listened on 127.0.0.1:9200. xerj autoindex /tmp/xerj-cline-sample --yes --no-graph finished xerj-done ok=true exit=0 reason=completed wall=0.9s files=2 records=3. cline config mcp printed xerj [stdio]. A Cline agent run against a local OpenAI-compatible stub completed with xerj__xerj_search and a hit on checkout.rs.
  • Assumed (not tested, and what would falsify it): that the VS Code / JetBrains Cline extension reads an equivalent mcpServers entry when opened from MCP Servers > Configure. Falsified if that UI ignores command/args/env or requires disabled and autoApprove. That a commercial model would choose to call the tool. Falsified if a keyed Cline session never surfaces xerj__xerj_search.
Open in Web Open in Cursor 

The supported-agents table said nobody had registered xerj mcp in Cline.
Cline CLI 3.0.73 on Linux loaded the README mcpServers block from
~/.cline/data/settings/cline_mcp_settings.json against xerj v1.0.0-rc.98
(the binary https://xerj.org/get installed). xerj_search was in the tool
list Cline sent the model, as xerj__xerj_search, among that binary's 20
tools, and Cline executed one xerj_search call that returned checkout.rs.

The model turn was a local OpenAI-compatible stub: no provider key was
available. The MCP process was the real xerj mcp. The IDE Configure
button was not run, and the README says so. disabled and autoApprove
were omitted and the CLI still connected.

Evidence: cline config mcp listed xerj [stdio]; the agent run's first
model request carried the 20 xerj tools; the tool result was the
ax-docs hit for checkout_error. xerj mcp --help on that binary says
"proxies 20 tools" and does not list xerj_def (added after the rc.98 tag).
@xerj-org
Copy link
Copy Markdown
Owner Author

Xerj Merger made the fix: marks the Cline row in the README MCP client table as tested (Cline CLI 3.0.73 on Linux against rc.98, from the Cline field report in #2301), in the English, Korean and Chinese READMEs.

@xerj-org
xerj-org merged commit 9673b22 into main Oct 24, 2026
23 checks passed
cursor Bot pushed a commit that referenced this pull request Oct 24, 2026
Main moved again while CI ran (#2298, #2300, #2302). Keep both
Unreleased Fixed notes: the persisted default_pipeline restart fix
(#2294) and the large-JSON ingest bound (#1122). No engine.rs conflict.
rehydrate_index_settings_from_disk is unchanged.

cargo fmt --all made no further edits.
Verified with rustc 1.97.1 from engine/:
- cargo test --profile ci-test -p xerj-api --test default_pipeline_survives_restart: 1 passed
- cargo test --profile ci-test -p xerj-engine -p xerj-api -- --test-threads=2: 2311 passed, 0 failed, 26 ignored

Co-authored-by: xerj-org <xerj-org@users.noreply.github.com>
cursor Bot pushed a commit that referenced this pull request Oct 24, 2026
Nine pull requests landed on main after the rc.99 cut. They are cited
in [1.0.0-rc.99] - 2026-10-23, and [Unreleased] stays empty.

- #2245 fixes #2234: _refresh no longer waits on a background merge.
- #2250 fixes #1612: autoindex estimates neural embedding time, and
  docs say --embed-mode is fixed at ingest.
- #2296 closes #2294: a persisted index.default_pipeline runs again
  after a clean restart.
- #2298: DeepSeek Harness profile bundle in dsh/, README links, and
  landing/brandbook/xerj-mark-400.png. dsh/package.json is 1.0.0-rc.99.
- #2300 and #2301: Cline is marked tested in the EN/KO/ZH README tables,
  with a field report. The run was against v1.0.0-rc.98.
- #2302 improves #1122, which stays open: a bulk reserves memory before
  parsing, and uncompressed JSON over 64 MiB is streamed.
- #2303 is part of #1170, which stays open: a document write is
  acknowledged once a quorum of copies confirms.
- #2308 fixes #2305: a semantic query over a wildcard, alias, or comma
  list skips indices that have no semantic_text field.

The window since v1.0.0-rc.98 is 91 merged pull requests. The 18 crate
versions in engine/Cargo.lock stay 1.0.0-rc.99. Landing footers that
this merge touched stay V1.0.0-RC.99. /product now says rc.99 lists
xerj hub next to xerj ask when the build has a hub signing key (#2282);
the rc.98 capture of that page is otherwise unchanged.

#2312 merged to corpus-hub, not main, so it is not in this cut.

Co-authored-by: xerj-org <xerj-org@users.noreply.github.com>
@cursor cursor Bot mentioned this pull request Oct 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

0