mcp-management

Monorepo for an MCP (Model Context Protocol) management stack: a Node.js server that loads plugins, registers tools via the MCP SDK, persists state, and speaks MCP over stdio, plus a Next.js web UI. Tooling is pnpm + Turborepo; packages are TypeScript-first.

Repository: github.com/mewisme/mcp

Requirements

• Node.js 22+ (see root package.json engines)

• pnpm 10+ (version pinned via packageManager in root package.json)

Quick start

pnpm install
pnpm dev

pnpm dev runs every workspace package’s dev script via Turborepo. To work on one app:

pnpm exec turbo dev --filter=@meewmeew/mcp    # MCP server (watch)
pnpm exec turbo dev --filter=@meewmeew/web    # Next.js app

Build, quality checks, and tests from the repo root:

pnpm build
pnpm lint
pnpm check-types
pnpm test

Format sources with Prettier: pnpm format.

What’s in the repo

Workspace layout is declared in pnpm-workspace.yaml (apps/*, packages/*).

MCP server (@meewmeew/mcp)

The server bootstraps in apps/server/src/bootstrap/, registers plugin loaders (built-in, and optionally path / package / bundle when allowed), runs a PluginManager with an execution policy, and exposes MCP over stdio.

• Published package: @meewmeew/mcp on npm (build output under apps/server/dist/).

• Local config: copy apps/server/.env.example to .env in the directory you run from (dotenv loads the cwd’s .env).

Persistence and logs

• JSON state: store.json under MCP_DATA_DIR (default ~/.mcp-management on the current user).

• Plugin audit log: {MCP_DATA_DIR}/logs/plugin-audit.log (Winston), separate from store.json.

• In-memory persistence: MCP_IN_MEMORY_PERSISTENCE=true, or when NODE_ENV=test.

Security / plugins

• External loaders (path, package, bundle) require MCP_ALLOW_EXTERNAL_PLUGINS=true; built-ins always load.

• Filesystem-related tooling respects blocked OS paths and optional MCP_FS_ALLOWED_ROOTS (comma-separated paths); see @meewmeew/shared.

Full CLI options, scripts table, and architecture notes: apps/server/README.md.

Web app (@meewmeew/web)

Next.js 16, React 19, Tailwind 4. Routes live under apps/web/src/app/. For editor/agent notes on this stack, see AGENTS.md and apps/web/AGENTS.md.

Versioning and release

• pnpm bump (or node scripts/bump.js [major|minor|patch]) bumps the root package.json version only.

• CI (.github/workflows/mcp-server.yml) on main: builds and tests @meewmeew/mcp, syncs apps/server/package.json from the root version, creates the vX.Y.Z git tag if missing, and publishes @meewmeew/mcp to npm when NPM_TOKEN is configured.

Documentation for contributors

• AGENTS.md — monorepo layout, commands, server mental model, how to add a built-in plugin (see also .cursor/skills/builtin-tool-plugin/SKILL.md).

Useful links

• Model Context Protocol

• Turborepo — tasks and filters