@hasna/mcps 0.0.9 → 0.0.11

package/README.md

@@ -1,6 +1,9 @@
-# mcps
+# @hasna/mcps
 
-Meta-MCP registry & CLI — discover, manage, and proxy MCP servers from a single interface. It is itself an MCP server, so AI agents can use it to discover and call tools from any registered MCP.
+Meta-MCP registry & CLI — discover, manage, and proxy MCP servers
+
+[![npm](https://img.shields.io/npm/v/@hasna/mcps)](https://www.npmjs.com/package/@hasna/mcps)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
 
 ## Install
 
@@ -8,122 +11,70 @@ Meta-MCP registry & CLI — discover, manage, and proxy MCP servers from a singl
 npm install -g @hasna/mcps
 ```
 
-## Quick Start
+## CLI Usage
 
 ```bash
-# Add MCP servers
-mcps add --name "GitHub" npx -y @modelcontextprotocol/server-github
-mcps add --name "Filesystem" npx -y @modelcontextprotocol/server-filesystem
-
-# List registered servers
-mcps list
-
-# Search the official MCP registry
-mcps search "database"
-
-# Connect and list all tools
-mcps tools --connect
-
-# Call a tool directly
-mcps call github__create_issue --json '{"repo":"owner/repo","title":"Bug"}'
-
-# Launch the web dashboard
-mcps serve
-
-# Launch the interactive TUI
-mcps
-
-# Start the meta-MCP server (for AI agents)
-mcps mcp
+mcps --help
 ```
 
-## Web Dashboard
-
-A local web dashboard for managing your MCP servers — built with React, shadcn/ui, and Tailwind CSS.
+- `mcps list`
+- `mcps search`
+- `mcps add`
+- `mcps remove`
+- `mcps enable`
+- `mcps disable`
+- `mcps tools`
+- `mcps call`
+- `mcps info`
+- `mcps doctor`
+- `mcps machines list`
+- `mcps machines add --host spark01 --platform linux --arch arm64`
+- `mcps machines seed-defaults`
+- `mcps fleet catalog`
+- `mcps fleet health --refresh`
+- `mcps fleet install --yes`
+
+## Fleet Operations
+
+Use machine registration plus fleet health/install commands to manage `@hasna/*`
+MCP packages across multiple hosts over SSH.
 
 ```bash
-mcps serve              # Opens http://localhost:19427
-mcps serve --port 3000  # Custom port
+mcps machines add --host spark01 --username hasna --platform linux --arch arm64
+mcps machines add --host apple01 --platform darwin --arch arm64
+mcps fleet health --refresh
+mcps fleet install --yes --mode missing-or-outdated
 ```
 
-Features: stats overview, sortable/filterable data table, enable/disable servers, add new servers, dark/light theme, pagination.
-
-## CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `mcps` | Launch interactive TUI |
-| `mcps list` | List registered MCP servers |
-| `mcps search <query>` | Search official MCP registry |
-| `mcps add <command> [args...]` | Add a local MCP server |
-| `mcps add --from-registry <id>` | Install from official registry |
-| `mcps remove <id>` | Remove a registered server |
-| `mcps enable <id>` | Enable a server |
-| `mcps disable <id>` | Disable a server |
-| `mcps tools [server-id]` | List tools (cached or `--connect` for live) |
-| `mcps call <tool> [--json]` | Call a tool directly |
-| `mcps info <id>` | Show server details & tools |
-| `mcps status` | Show registry stats |
-| `mcps serve` | Start web dashboard |
-| `mcps mcp` | Start meta-MCP server (stdio) |
-
-## Architecture
+Notes:
 
-```
-┌──────────────────┐  ┌─────────────────────┐  ┌──────────────────────────┐
-│   Ink TUI        │  │   Headless CLI       │  │   MCP Server (meta)      │
-│   `mcps`         │  │   `mcps search`      │  │   `mcps mcp`             │
-└────────┬─────────┘  └──────────┬───────────┘  └──────────┬───────────────┘
-         │                       │                         │
-         └───────────┬───────────┴─────────────────────────┘
-                     │
-             ┌───────▼────────┐
-             │  Core Library   │
-             │  - Registry     │  ← SQLite (local MCPs)
-             │  - Remote       │  ← Official MCP Registry API
-             │  - Proxy        │  ← MCP SDK Client (connect to MCPs)
-             └────────────────┘
-```
-
-**Data flow:** User adds server → stored in SQLite (`~/.mcps/registry.db`) → `connectToServer()` spawns process → `listTools()` → tools cached → `callTool("server__tool", args)` routes to correct upstream.
-
-## Meta-MCP Server
+- Fleet commands only target enabled machines.
+- `mcps fleet install` requires `--yes` because it performs remote installs.
+- Targets need SSH access plus `node` and either `bun` or `npm` available remotely.
+- Use `-j` or `--json` on the new `machines` and `fleet` commands for scriptable output.
 
-When running as an MCP server (`mcps mcp`), it exposes:
+## MCP Server
 
-**Management tools:** `list_servers`, `search_registry`, `add_server`, `install_from_registry`, `remove_server`, `enable_server`, `disable_server`, `get_server_info`
-
-**Proxy tools:** `connect_and_list_tools`, `call_upstream_tool` — calls are routed to the correct upstream server using prefixed tool names (`server_id__tool_name`)
+```bash
+mcps-mcp
+```
 
-## Library Usage
+The MCP server exposes registry, finder, machine registry, and fleet orchestration tools.
 
-```typescript
-import { addServer, connectToServer, listAllTools, callTool } from "@hasna/mcps";
+## Cloud Sync
 
-const server = addServer({
-  name: "GitHub",
-  command: "npx",
-  args: ["-y", "@modelcontextprotocol/server-github"],
-});
+This package supports cloud sync via `@hasna/cloud`:
 
-await connectToServer(server);
-const tools = listAllTools();
-const result = await callTool("github__create_issue", { repo: "owner/repo", title: "Bug" });
+```bash
+cloud setup
+cloud sync push --service mcps
+cloud sync pull --service mcps
 ```
 
-## Development
+## Data Directory
 
-```bash
-bun install
-bun run dev            # Run CLI in dev mode
-bun run dev:mcp        # Run MCP server in dev mode
-bun run dev:dashboard  # Run dashboard in dev mode (Vite)
-bun run serve          # Run dashboard server
-bun test               # Run tests (127 tests)
-bun run typecheck      # Type-check
-bun run build          # Build everything
-```
+Data is stored in `~/.hasna/mcps/`.
 
 ## License
 
-Apache-2.0
+Apache-2.0 -- see [LICENSE](LICENSE)