You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Remove github MCP server from all 10 hosts that had it (and fill-keys/docs)
- Remove memory MCP server from all 5 hosts that had it (and docs)
- Upgrade brave-search: @modelcontextprotocol/server-brave-search → @brave/brave-search-mcp-server
- Add perplexity-mcp server to all 14 hosts with PERPLEXITY_API_KEY placeholder
- Hardcode filesystem path to /spacecraft-software across all hosts
- Update fill-keys scripts: drop GITHUB_PAT, add PERPLEXITY_API_KEY
- Update server counts and docs in README.md and CLAUDE.md
- All 17 config files validate clean
Filled configs are written to `dist/` directory (gitignored).
@@ -71,7 +70,7 @@ To add support for a new MCP-capable tool:
71
70
72
71
1.**Create new directory**: Named after the host tool (case-sensitive)
73
72
2.**Add config template**: Follow the host's schema (use `host mcp add` if available)
74
-
3.**Include all nine servers**: Maintain consistency across hosts
73
+
3.**Include all ten servers**: Maintain consistency across hosts
75
74
4.**Add to fill-keys scripts**: Update the host-file list in all three shell scripts
76
75
5.**Update README**: Add to the supported hosts table
77
76
6.**Update CLAUDE.md**: Add to the layout table with schema notes
@@ -91,7 +90,7 @@ This repo carries the Standard §5.2 posture files and §4.3 REUSE metadata:
91
90
Each directory is named after the host application that consumes the file. The
92
91
files are **templates**; each holds only the MCP-relevant fragment (never a copy of a
93
92
tool's full personal config, which would carry auth tokens). Each template declares the
94
-
full **nine-server superset** (see below). Note this differs from the maintainer's live
93
+
full **ten-server superset** (see below). Note this differs from the maintainer's live
95
94
machine configs, which run only the three real servers — the six generic `npx`/token
96
95
servers ship in the templates as placeholders, not in the live configs. Host config
97
96
paths are noted below.
@@ -124,29 +123,29 @@ those files. Mind the traps: **Qwen uses `httpUrl`** while Gemini uses `url`+`ty
124
123
125
124
## The servers being configured
126
125
127
-
Every host template declares all nine. Two groups:
126
+
Every host template declares all ten. Two groups:
128
127
129
128
**The four "real" servers** (these run in the maintainer's live configs):
130
129
-**nixos** — `mcp-nixos` (queries nixpkgs / NixOS options). Antigravity runs the `mcp-nixos` binary directly; everywhere else it's `nix run github:utensils/mcp-nixos --` over stdio.
131
130
-**context7** (Upstash) — HTTP, `https://mcp.context7.com/mcp`, needs a `CONTEXT7_API_KEY`. Stored inline under a header (`CONTEXT7_API_KEY` for most hosts; `Authorization: Bearer …` for VS Code, where it comes from a prompted `input`). Placeholder `YOUR_CONTEXT7_API_KEY`.
132
131
-**microsoft-learn** — HTTP, `https://learn.microsoft.com/api/mcp`, no auth.
133
132
-**crates** — stdio, `crates-mcp` ([crates-mcp](https://crates.io/crates/crates-mcp) via `cargo install`), queries Rust crates from crates.io and docs.rs.
134
133
135
-
**The six generic servers** (came in via the merged Copilot PRs; templates-only, placeholders):
- Antigravity's file uses **2-space** indentation; VS Code's uses **tabs**. Preserve each file's existing style. Host directory names are **case-sensitive and canonical** (`Antigravity/`, `VSCode/`) — do not reintroduce lowercase `antigravity/` or `.vscode/` variants (a past PR did; they were consolidated).
144
-
- Never commit a real secret — templates carry placeholders (`YOUR_CONTEXT7_API_KEY`, `YOUR_GITHUB_PAT`, `YOUR_BRAVE_API_KEY`). The filesystem server uses the hardcoded `/spacecraft-software` path. Servers needing placeholders stay inert until filled in locally.
143
+
- Never commit a real secret — templates carry placeholders (`YOUR_CONTEXT7_API_KEY`, `YOUR_BRAVE_API_KEY`, `YOUR_PERPLEXITY_API_KEY`). The filesystem server uses the hardcoded `/spacecraft-software` path. Servers needing placeholders stay inert until filled in locally.
145
144
- Templates are the **canonical superset**; the maintainer's live machine runs the three real servers only. When changing a server, update **every** host template in its dialect (and the live config too, for the three real servers).
146
145
147
146
## Tooling
148
147
149
-
`bin/fill-keys.{nu,sh,ion}` substitute the three placeholder tokens (`YOUR_CONTEXT7_API_KEY`, `YOUR_BRAVE_API_KEY`, `YOUR_GITHUB_PAT`) with values from env vars (prompting for any unset ones when interactive) and write filled copies into a **gitignored `dist/` mirror** — they never edit the tracked templates, so the no-secrets rule holds. There are three parallel ports (Nushell, POSIX/Bash/Brush, Ion) with identical behavior — **change all three together**, plus their shared host-file list (the docs and VS Code's `${input:}` field is deliberately left out). The `.sh`/`.ion` ports shell out to `sd` (literal `-s` mode); the `.nu` port uses native string ops. These are the only executables (`755`); everything else is `644` data. Shell-specific gotchas worth knowing if you edit them: Ion's `test -t` is unreliable (use `tty -s`), Ion eats `-h`/`--help`, and Ion's `test` needs the POSIX `x`-prefix guard for `--`-leading operands.
148
+
`bin/fill-keys.{nu,sh,ion}` substitute the three placeholder tokens (`YOUR_CONTEXT7_API_KEY`, `YOUR_BRAVE_API_KEY`, `YOUR_PERPLEXITY_API_KEY`) with values from env vars (prompting for any unset ones when interactive) and write filled copies into a **gitignored `dist/` mirror** — they never edit the tracked templates, so the no-secrets rule holds. There are three parallel ports (Nushell, POSIX/Bash/Brush, Ion) with identical behavior — **change all three together**, plus their shared host-file list (the docs and VS Code's `${input:}` field is deliberately left out). The `.sh`/`.ion` ports shell out to `sd` (literal `-s` mode); the `.nu` port uses native string ops. These are the only executables (`755`); everything else is `644` data. Shell-specific gotchas worth knowing if you edit them: Ion's `test -t` is unreliable (use `tty -s`), Ion eats `-h`/`--help`, and Ion's `test` needs the POSIX `x`-prefix guard for `--`-leading operands.
150
149
151
150
## Code Architecture and Structure
152
151
@@ -155,7 +154,7 @@ Every host template declares all nine. Two groups:
155
154
The repository follows a **multi-host template pattern** where:
156
155
157
156
1.**Each host directory** contains a single config file in that host's native format
158
-
2.**All configs declare the same nine servers** but in different dialects
157
+
2.**All configs declare the same ten servers** but in different dialects
159
158
3.**Templates use placeholders** for secrets that get filled at deployment time
160
159
4.**No real secrets are committed** - placeholders ensure safety
0 commit comments