mcp-servers

Per-tool MCP (Model Context Protocol) server configurations for the coding agents and editors I use. Each directory holds the MCP config fragment for one host, in that host's own dialect. They all wire up the same nine servers:

Server	Transport	Endpoint / command	Auth
nixos	stdio	nix run github:utensils/mcp-nixos -- (mcp-nixos) — nixpkgs / NixOS options	none
context7	http	https://mcp.context7.com/mcp — Upstash Context7 library docs	CONTEXT7_API_KEY
microsoft-learn	http	https://learn.microsoft.com/api/mcp — Microsoft Learn docs	none
github	http	https://api.githubcopilot.com/mcp/ — GitHub API (repos, PRs, issues, code search)	GitHub PAT
filesystem	stdio	npx -y @modelcontextprotocol/server-filesystem <path> — sandboxed file access	none (set a path)
fetch	stdio	npx -y @modelcontextprotocol/server-fetch — fetch live web content	none
memory	stdio	npx -y @modelcontextprotocol/server-memory — knowledge-graph memory	none
brave-search	stdio	npx -y @modelcontextprotocol/server-brave-search — web search	BRAVE_API_KEY
sequential-thinking	stdio	npx -y @modelcontextprotocol/server-sequential-thinking — step-by-step reasoning	none

The npx-based servers need Node.js 18+. github, brave-search, and filesystem need a token or path filled in before they work (see Notes).

Supported hosts

Directory	Host	Live config path
Antigravity/	Antigravity	editor-managed
VSCode/	VS Code	.vscode/mcp.json
GitHubCopilotCLI/	GitHub Copilot CLI	~/.copilot/mcp-config.json
ClaudeCode/	Claude Code	~/.claude.json
OpenClaude/	OpenClaude	~/.openclaude.json
Codex/	OpenAI Codex	~/.codex/config.toml
Grok/	Grok CLI	~/.grok/config.toml
Kimi/	Kimi Code CLI	~/.kimi-code/config.toml
Gemini/	Gemini CLI	~/.gemini/settings.json
Qwen/	Qwen Code	~/.qwen/settings.json
OpenCode/	opencode	~/.config/opencode/opencode.jsonc
Goose/	goose	~/.config/goose/config.yaml

Notes

• Files are templates with placeholders — replace these locally, never commit real values: YOUR_CONTEXT7_API_KEY, YOUR_GITHUB_PAT, YOUR_BRAVE_API_KEY, and the filesystem server's /path/to/your/workspace. Until they're filled in, those servers won't connect (the other servers work as-is). VS Code instead prompts for the Context7 and Brave keys via its inputs mechanism, and uses built-in Copilot auth for github.
• Schemas differ per host (e.g. Qwen uses httpUrl, Codex uses http_headers, Copilot CLI omits the mcpServers wrapper). See CLAUDE.md for the full per-host schema table.

Filling in your keys

bin/fill-keys.* substitutes the placeholders with your real values and writes ready-to-use copies into a gitignored dist/ mirror — the tracked templates are never modified, so no secret is ever committed. The same tool is provided for three shells (pick whichever you run); all behave identically:

Script	Shell	Notes
bin/fill-keys.nu	Nushell	no external deps (native string ops)
bin/fill-keys.sh	POSIX sh / Bash / Brush	needs sd
bin/fill-keys.ion	Ion	needs sd; Ion eats -h/--help itself, so see the file header for usage

Env var	Fills	Server
CONTEXT7_API_KEY	YOUR_CONTEXT7_API_KEY	context7
BRAVE_API_KEY	YOUR_BRAVE_API_KEY	brave-search
GITHUB_PAT	YOUR_GITHUB_PAT	github
WORKSPACE_PATH	/path/to/your/workspace	filesystem

# Provide values via env vars (any you omit are prompted for, or left as placeholders
# when run non-interactively). Use whichever script matches your shell:
CONTEXT7_API_KEY=ctx7sk-... BRAVE_API_KEY=... GITHUB_PAT=ghp_... \
  WORKSPACE_PATH=/home/you/work \
  nu bin/fill-keys.nu          # or: sh bin/fill-keys.sh  /  ion bin/fill-keys.ion

nu bin/fill-keys.nu --help        # options (Nushell/POSIX; Ion: see header)
nu bin/fill-keys.nu --out /tmp/mcp   # write somewhere else

The script prints each filled file's intended install destination. Copy the relevant dist/<Host>/… file to that path (whole-file for most hosts; for hosts whose live config holds other settings — Codex, Claude Code, Grok, Kimi, OpenClaude — merge the MCP block in). Omitted keys keep their placeholder, so that server simply stays inert. VS Code is copied unchanged: it prompts for the Context7/Brave keys itself.

Project Posture

mcp-servers is a personal hobby project under the Spacecraft Software umbrella. It is developed at hobby pace and shaped around the maintainer's own toolchain, not a general audience.

• No warranty, no liability. See NOTICE.md.
• Contributions are welcome but not guaranteed. See CONTRIBUTING.md.
• Forking is encouraged. GPL-3.0-or-later is there for exactly that.

License

Licensed under GPL-3.0-or-later. This repository is REUSE- compliant: license texts live in LICENSES/ and per-file copyright/license metadata is declared in REUSE.toml. The root LICENSE is retained for GitHub's license detection.

Maintainer

Mohamed Hammad <Mohamed.Hammad@SpacecraftSoftware.org> Copyright (C) 2026 Mohamed Hammad & Spacecraft Software Website: https://SpacecraftSoftware.org/

---

--- Forged in Spacecraft Software ---