an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions
HTML agent-harnessagent-orchestrationagentsai-agentsautonomous-agentsclaude-codecodexcoding-agentsdesktop-appdeveloper-toolselectrongemini-cliharnessharness-engineeringlocal-firstmemorymulti-agentopencodeorchestrationtypescript
/**
* Default MCP server catalog (Workstream 3). A dependency-free, importable-by-both
* (main + renderer) registry of the MCP servers Munder Difflin can wire into each
* agent's per-session `settings.json`. Keep it free of electron/UI/node imports.
*
* Tiers gate consent:
* - 'safe-readonly' → no secret, no destructive write OUTSIDE the agent cwd; shipped
* ON by default (`defaultEnabled:true`). `filesystem`/`git` are
* scoped to the agent cwd at merge time (never whole-disk).
* - 'write' → can mutate state beyond the workspace; OFF by default,
* consent-gated.
* - 'secret' → needs an API key / token / connection string; OFF by default,
* consent-gated.
*
* The actual merge (catalog ∩ enabled, cwd-scoping of filesystem/git, id namespacing,
* non-fatal resolution) is Workstream 3's `buildDefaultMcpServers`/`hookSettings`
* job — this module only declares the entries, their tiers, and the seed defaults.
*
* NOTE: several reference servers ship as Python (uvx) rather than npm (npx). The
* commands below reflect each server's real transport; entries that couldn't be
* verified against an installed server are flagged `// TODO-verify`. Workstream 3
* makes a server that fails to resolve non-fatal to the agent.
*/
export type McpTier = 'safe-readonly' | 'write' | 'secret';
export interface McpCatalogEntry {
/** Stable catalog id (also the consent key in `config.mcpDefaults`). The merge
* step namespaces the written server id (e.g. `munder-<id>`) to avoid clobbering
* a user's own `~/.claude` MCP server of the same name. */
id: string;
/** Human label for the consent UI. */
label: string;
/** One-line description for the consent UI / hire import preview. */
description: string;
/** The MCP stdio server launch spec. `filesystem`/`git` carry a placeholder cwd
* arg that Workstream 3 replaces with the agent cwd at merge time. */
spec: {
command: string;
args: string[];
/** Required env (e.g. an API token). Present only on write/secret entries; the
* value is supplied via consent, never hard-coded here. */
env?: Record<string, string>;
};
tier: McpTier;
/** Seed for `config.mcpDefaults[id].enabled`. Always === (tier === 'safe-readonly'). */
defaultEnabled: boolean;
}
/** The default MCP bundle. Safe/read-only servers are ON; anything that writes
* beyond the workspace or needs a secret is OFF until the user consents. */
export const MCP_CATALOG: McpCatalogEntry[] = [
// ─── Safe, read-only, no-secret — shipped ON ──────────────────────────────
{
id: 'sequential-thinking',
label: 'Sequential Thinking',
description: 'Structured step-by-step reasoning scratchpad. No I/O, no secrets.',
spec: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-sequential-thinking'] },
tier: 'safe-readonly',
defaultEnabled: true
},
{
id: 'time',
label: 'Time',
description: 'Current time and timezone conversions.',
// Reference time server ships as Python. // TODO-verify transport (uvx vs an npm port)
spec: { command: 'uvx', args: ['mcp-server-time'] },
tier: 'safe-readonly',
defaultEnabled: true
},
{
id: 'fetch',
label: 'Fetch',
description: 'Fetch a URL and return its content as markdown (read-only HTTP GET).',
// Reference fetch server ships as Python. // TODO-verify transport (uvx vs an npm port)
spec: { command: 'uvx', args: ['mcp-server-fetch'] },
tier: 'safe-readonly',
defaultEnabled: true
},
{
id: 'context7',
label: 'Context7 Docs',
description: 'Up-to-date library/framework documentation lookups.',
spec: { command: 'npx', args: ['-y', '@upstash/context7-mcp'] },
tier: 'safe-readonly',
defaultEnabled: true
},
{
id: 'filesystem',
label: 'Filesystem (cwd)',
description: 'Read/edit files within the agent workspace only (scoped to cwd at spawn).',
// The trailing arg is the allowed root — Workstream 3 replaces this placeholder
// with the agent cwd at merge time so it is NEVER whole-disk.
spec: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', '<cwd>'] },
tier: 'safe-readonly',
defaultEnabled: true
},
{
id: 'git',
label: 'Git (cwd)',
description: 'Inspect git status/log/diff for the workspace repo (scoped to cwd at spawn).',
// Reference git server ships as Python; `--repository <cwd>` is set at merge time.
// TODO-verify transport (uvx vs an npm port).
spec: { command: 'uvx', args: ['mcp-server-git', '--repository', '<cwd>'] },
tier: 'safe-readonly',
defaultEnabled: true
},
// ─── Write / secret — shipped OFF, consent-gated ──────────────────────────
{
id: 'github-token',
label: 'GitHub',
description: 'Read/write GitHub issues, PRs, and repos. Requires a personal access token.',
spec: {
command: 'npx',
args: ['-y', '@modelcontextprotocol/server-github'],
env: { GITHUB_PERSONAL_ACCESS_TOKEN: '' }
},
tier: 'secret',
defaultEnabled: false
},
{
id: 'db',
label: 'Database',
description: 'Query a SQL database. Requires a connection string.',
// TODO-verify exact server package for the user's DB engine (Postgres assumed).
spec: {
command: 'npx',
args: ['-y', '@modelcontextprotocol/server-postgres'],
env: { DATABASE_URL: '' }
},
tier: 'secret',
defaultEnabled: false
},
{
id: 'email-calendar',
label: 'Email & Calendar',
description: 'Read/send mail and read/write calendar events. Requires account credentials.',
// TODO-verify provider package (Gmail/Google Calendar assumed).
spec: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-gsuite'], env: { GOOGLE_OAUTH_TOKEN: '' } },
tier: 'secret',
defaultEnabled: false
},
{
id: 'search-with-key',
label: 'Web Search',
description: 'Keyed web search. Requires a search-provider API key.',
// TODO-verify provider package (Brave Search assumed).
spec: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-brave-search'], env: { BRAVE_API_KEY: '' } },
tier: 'secret',
defaultEnabled: false
}
];
/** Look up a catalog entry by id. */
export function mcpCatalogEntry(id: string): McpCatalogEntry | undefined {
return MCP_CATALOG.find((e) => e.id === id);
}
/** Whether an id is a known safe-readonly server (the only tier a hire manifest may
* request without surfacing for human consent — Workstream 3 validation). */
export function isSafeReadonlyMcp(id: string): boolean {
return mcpCatalogEntry(id)?.tier === 'safe-readonly';
}
/** Seed for `DEFAULTS.mcpDefaults` — derived from the catalog so the two never
* drift (safe-readonly ON, write/secret OFF). */
export function defaultMcpDefaults(): Record<string, { enabled: boolean }> {
const out: Record<string, { enabled: boolean }> = {};
for (const e of MCP_CATALOG) out[e.id] = { enabled: e.defaultEnabled };
return out;
}