Skip to content

Add MCP host templates (9 servers × 12 hosts), posture files, and REUSE compliance#3

Merged
UnbreakableMJ merged 4 commits into
mainfrom
add-mcp-hosts-and-posture
Jun 16, 2026
Merged

Add MCP host templates (9 servers × 12 hosts), posture files, and REUSE compliance#3
UnbreakableMJ merged 4 commits into
mainfrom
add-mcp-hosts-and-posture

Conversation

@UnbreakableMJ

Copy link
Copy Markdown
Collaborator

Summary

Brings the repo up to a coherent, Standard-compliant state and reconciles it with the
recently merged Copilot PRs (#1, #2).

  • 12 host templates, 9 servers each. Every host now ships the full nine-server set in
    its own dialect: the three real servers (nixos, context7, microsoft-learn) plus the
    six generic servers from the merged PRs (github, filesystem, fetch, memory,
    brave-search, sequential-thinking). Hosts: Antigravity, VS Code, GitHub Copilot CLI,
    Claude Code, OpenClaude, OpenAI Codex, Grok, Kimi Code, Gemini, Qwen, opencode, goose.
  • Consolidated duplicate dirs. The merged PRs introduced case-variant lowercase
    antigravity/ and .vscode/ alongside the canonical Antigravity/ and VSCode/. These
    are removed and their servers folded into the canonical files.
  • Spacecraft Software compliance. Adds §5.2 posture files (NOTICE.md,
    CONTRIBUTING.md, README Project Posture section), ships LICENSES/GPL-3.0-or-later.txt,
    and declares per-file SPDX metadata via REUSE.toml. reuse lint is clean (17/17).
  • Docs. README.md documents all 9 servers + 12 hosts; CLAUDE.md carries the
    per-host schema table and the dialect traps.

Dialect notes (per-host schema differs)

  • Qwen uses httpUrl; Gemini uses url + type.
  • Codex uses http_headers; Grok and Kimi use headers.
  • Copilot CLI omits the mcpServers wrapper (top-level keys).
  • Gemini needs the separate mcp-server-enablement.json and a trusted folder.
  • Kimi's active config is ~/.kimi-code/config.toml (the ~/.kimi/ path is pre-migration).

Placeholders / scope

Generic servers ship as placeholders (YOUR_GITHUB_PAT, YOUR_BRAVE_API_KEY,
/path/to/your/workspace) and are templates-only — they are intentionally not added to
the maintainer's live machine configs, which continue to run just the three real servers.
No real secrets are committed.

All commits are signed/verified (Standard §6.3).

🤖 Generated with Claude Code

UnbreakableMJ and others added 4 commits June 16, 2026 16:14
Extend the nixos + context7 + microsoft-learn server set beyond the
existing Antigravity and VS Code templates to every installed CLI agent:
GitHub Copilot CLI, Claude Code, OpenClaude, OpenAI Codex, Grok, Kimi
Code, Gemini, Qwen, opencode, and goose.

Each new directory holds the MCP fragment in that host's own dialect
(top-level vs mcpServers wrapper, TOML tables, YAML extensions; httpUrl
vs url+type; http_headers vs headers). Context7 uses the
YOUR_CONTEXT7_API_KEY placeholder. README and CLAUDE.md document the
full per-host schema table and the dialect traps.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Prepare the repo for migration to the Spacecraft-Software org per the
Standard: add the §5.2 posture files (NOTICE.md, CONTRIBUTING.md, and a
Project Posture section in README) tailored to this config-template repo,
ship the GPL-3.0-or-later text under LICENSES/, and declare per-file
SPDX metadata via REUSE.toml (single path="**" annotation; templates stay
header-free so they can be copied verbatim into users' host configs).

reuse lint is clean (17/17 files). CLAUDE.md documents the compliance setup.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Reconcile the migrated origin/main (which had merged Copilot PRs) with the
local templates. Every one of the 12 host templates now declares all nine
servers in its own dialect: the three real servers (nixos, context7,
microsoft-learn) plus the six generic servers from the PRs (github,
filesystem, fetch, memory, brave-search, sequential-thinking).

The PRs had introduced case-variant duplicate directories (lowercase
antigravity/ and .vscode/) alongside the canonical Antigravity/ and VSCode/;
these are removed and their servers folded into the canonical files.

Generic servers ship as placeholders (YOUR_GITHUB_PAT, YOUR_BRAVE_API_KEY,
/path/to/your/workspace) and are templates-only — the maintainer's live
machine configs still run just the three real servers. README and CLAUDE.md
updated; reuse lint clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
GitHub Actions workflow runs on PRs and pushes to main:
- reuse lint (REUSE spec compliance)
- a Python validator that parses every JSON/JSONC/TOML/YAML config by
  extension, so a malformed template or a REUSE regression fails the PR.

New host templates are picked up automatically (the validator walks the
tree). Both checks pass locally: reuse lint clean, 15 config files valid.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@UnbreakableMJ
UnbreakableMJ merged commit 81aa723 into main Jun 16, 2026
1 check passed
@UnbreakableMJ
UnbreakableMJ deleted the add-mcp-hosts-and-posture branch June 16, 2026 14:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant