From a1a0e2a173178557a256e61abdb791cea3e64593 Mon Sep 17 00:00:00 2001 From: Eliott Jacopin Date: Sun, 28 Jun 2026 19:49:19 +0900 Subject: [PATCH 1/3] docs(readme): add manual install methods for local-clone workflows Users who prefer a local clone over the plugin marketplace now have two options: Hatch! (multi-host CLI registration with sync and backup) or direct .mcp.json editing. Both share a common rikyu-doctor verify step. Co-Authored-By: Claude Opus 4.6 --- README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) diff --git a/README.md b/README.md index e7fe67c..d942704 100644 --- a/README.md +++ b/README.md @@ -48,6 +48,69 @@ codex plugin marketplace add RIKEN-RCCS/Rikyu-Agent Then open `/plugins`, install `rikyu`, start a new thread, and run `/ai4s-demo` to verify the connection end-to-end. +### Manual (any MCP-compatible client) + +Clone the repository wherever you prefer: + +```bash +git clone https://github.com/RIKEN-RCCS/Rikyu-Agent.git +``` + +#### Option A — Using Hatch! + +[Hatch!](https://github.com/CrackingShells/Hatch) registers MCP servers on +any supported host from a single command. Install it once, then configure +both servers — replace `/path/to/Rikyu-Agent` with the actual clone location +and `` with your target platform (`claude-code`, `codex`, `cursor`, +`vscode`, `claude-desktop`, `kiro`, `gemini`, `lmstudio`, or any other +[supported host](https://github.com/CrackingShells/Hatch#supported-mcp-hosts)): + +```bash +pip install hatch-xclam + +hatch mcp configure rikyu-hpc --host \ + --command uv --args "run" "--directory" "/path/to/Rikyu-Agent/server" "rikyu-hpc-mcp" + +hatch mcp configure rikyu-docs --host \ + --command uv --args "run" "--directory" "/path/to/Rikyu-Agent/server" "rikyu-docs-mcp" +``` + +To replicate the same configuration to additional hosts: + +```bash +hatch mcp sync --from-host --to-host cursor,vscode +``` + +#### Option B — Edit `.mcp.json` directly + +Create or edit `.mcp.json` in your project root, replacing `/path/to/Rikyu-Agent` +with the actual clone location: + +```json +{ + "mcpServers": { + "rikyu-hpc": { + "command": "uv", + "args": ["run", "--directory", "/path/to/Rikyu-Agent/server", "rikyu-hpc-mcp"], + "env": {} + }, + "rikyu-docs": { + "command": "uv", + "args": ["run", "--directory", "/path/to/Rikyu-Agent/server", "rikyu-docs-mcp"], + "env": {} + } + } +} +``` + +#### Verify + +Whichever option you chose, run the doctor check to verify connectivity: + +```bash +uv run --directory /path/to/Rikyu-Agent/server rikyu-doctor +``` + ## Configuration Settings live in `~/.rikyu/config.json`: From fbc98b5620edee43847a26f8a488975b5a61cd91 Mon Sep 17 00:00:00 2001 From: Eliott Jacopin Date: Sun, 28 Jun 2026 19:52:30 +0900 Subject: [PATCH 2/3] chore(gitignore): exclude uv.lock from version control The server is consumed via uv tool run which resolves its own dependencies; a committed lock file would drift without benefit. Co-Authored-By: Claude Opus 4.6 --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index ffe6af4..c88efcc 100644 --- a/.gitignore +++ b/.gitignore @@ -7,5 +7,6 @@ hpc-ai-mcp/ .claude/settings.local.json server/dataset-* remotemanager.log +uv.lock # Third-party IRI spec (ALCF, no redistribution license) — fetch when needed (see AGENTS.md) openapi.json From 9e7a8e4a0a2376996d132a4cd94b658869140d38 Mon Sep 17 00:00:00 2001 From: Eliott Jacopin Date: Sun, 28 Jun 2026 20:05:59 +0900 Subject: [PATCH 3/3] fix(readme): use single-string format for hatch --args Hatch! expects --args as a single quoted string, not separate tokens. Co-Authored-By: Claude Opus 4.6 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d942704..85aa75a 100644 --- a/README.md +++ b/README.md @@ -69,10 +69,10 @@ and `` with your target platform (`claude-code`, `codex`, `cursor`, pip install hatch-xclam hatch mcp configure rikyu-hpc --host \ - --command uv --args "run" "--directory" "/path/to/Rikyu-Agent/server" "rikyu-hpc-mcp" + --command uv --args "run --directory /path/to/Rikyu-Agent/server rikyu-hpc-mcp" hatch mcp configure rikyu-docs --host \ - --command uv --args "run" "--directory" "/path/to/Rikyu-Agent/server" "rikyu-docs-mcp" + --command uv --args "run --directory /path/to/Rikyu-Agent/server rikyu-docs-mcp" ``` To replicate the same configuration to additional hosts: