Learning Hub

MCPUP

This hub turns the real MCPUP repo into three separate learning dashboards: how the tool works logically, how the codebase works internally, and how to use it like a pro. Everything here is based on the current snapshot of /Users/mohammedamin/Projects/MP.

Version 0.1.0 6 CLI commands 4 adapter keys implemented 52 tests passing 
MCPUP mental model

mp add / enable / disable / remove
                |
                v
      ~/.mcpup/config.json
                |
                v
            mp sync
                |
                v
    client config files on disk

Courses

Choose Your Track

Course 1

MCPUP v0.1 Logic

Learn the actual mental model: central config, per-client enable state, sync pipeline, file formats, and what is really implemented today.

Course 2

Inside MCPUP

Tour the codebase, folder layout, key files, tech stack, design patterns, and why Typer, Pydantic, Rich, pytest, and the adapter pattern matter here.

Course 3

MCPUP Power User

Learn the best workflows, command recipes, safety habits, debugging approach, and the practical limits of this v0.1 tool so you can operate it confidently.

Snapshot

Repo Snapshot This Hub Teaches

6

Real root commands: add remove list enable disable sync

4

Actual adapter registry keys: claude-code, claude-desktop, cursor, codex

JSON + TOML

MCPUP uses JSON centrally; Codex is the only current client using TOML.

52/52

Current local test run: uv run pytest -q passed.

Reality Check

Plan vs Current Code

What is already real

  • Central config at ~/.mcpup/config.json
  • Validated server models with Pydantic
  • Atomic config writes
  • CLI built with Typer
  • Adapter-based sync for four client keys
  • CLI, config, and adapter tests

What is not fully there yet

  • No separate codex-desktop adapter key
  • No update or modify command
  • No import or discovery flow
  • No UI, no auto-sync, no cloud sync
  • End-to-end sync is less tested than individual parts

Map

Repo Shape

MP/
|-- src/mcpup/main.py
|-- src/mcpup/config/
|-- src/mcpup/cli/
|-- src/mcpup/clients/
|-- tests/config/
|-- tests/cli/
`-- tests/clients/
Area Job
config/ Data models plus load/save logic
cli/ One file per user command
clients/ Per-client read/build/write adapters
tests/ Behavior guarantees for models, CLI, adapters