@agimon-ai/doompi-mcp 0.0.1-alpha.21 → 0.0.1-alpha.23

package/README.md

@@ -1,41 +1,96 @@
 # @agimon-ai/doompi-mcp
 
-**A session should not start a server it cannot use.**
+Domain-aware MCP selection for DoomPi and a standalone MCP adapter for Pi.
 
-This is Doompi's MCP gate. It reads repository and plugin MCP config, applies the selected
-domains' allowlist, and removes disallowed servers before any stdio process is spawned. A
-filtered server is absent, not merely hidden from the model.
+Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
 
-Direct servers come from `.mcp.json`. Proxy upstreams come from `mcp-config.yaml`. Doompi
-can filter both, emit the resolved config for Pi, and rebuild it when domains change.
-Outside Doompi, the adapter still works as a plain Pi extension and uses the repository's
-`.mcp.json` without a domain allowlist.
+The package removes disallowed servers before any stdio process is spawned. A filtered server is absent rather than merely hidden from the model.
 
-This is part of [Doompi](https://www.npmjs.com/package/@agimon-ai/doompi). Most users get
-it with the distribution.
+> **Alpha:** configuration and adapter contracts may change between releases.
+
+## Requirements
+
+- Node.js 22.19.0 or newer
+- Pi 0.84.2 and Pi TUI 0.84.2
 
 ## Install
 
+DoomPi loads the Doom adapter as core; domain selection controls access. For plain Pi:
+
 ```bash
-npm install @agimon-ai/doompi-mcp
+pi install npm:@agimon-ai/doompi-mcp
+```
+
+| Entry                                   | Purpose                                                  |
+| --------------------------------------- | -------------------------------------------------------- |
+| `@agimon-ai/doompi-mcp/extensions/doom` | DoomPi adapter and domain boundary                       |
+| `@agimon-ai/doompi-mcp/extensions/pi`   | Standalone Pi adapter using repository MCP configuration |
+| `@agimon-ai/doompi-mcp`                 | Library API                                              |
+
+## Configure direct servers
+
+Repository `.mcp.json` entries describe direct MCP servers:
+
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    }
+  }
+}
+```
+
+Proxy upstreams are read from `mcp-config.yaml`. Domains can select direct `servers` and proxy upstreams separately:
+
+```yaml
+domains:
+  development:
+    description: Repository development tools.
+    mcp:
+      servers: [filesystem]
+      proxy: [github]
 ```
 
-## How it loads
+An absent or empty allowlist retains configured entries. Use `--no-mcp` when no MCP server should load. In plain-Pi mode, no DoomPi domain allowlist is applied.
 
-Doompi loads the adapter as core; server access is what the domain selection makes
-optional. The package does not belong in `.doom/modes.yaml`.
+## Commands
 
-The bare package name follows its Pi manifest and selects the Doom adapter. Use
-`/extensions/pi` for a standalone Pi session or `/extensions/doom` when selecting the Doom
-integration explicitly.
+```text
+/mcp
+/mcp status
+/mcp auth <server>
+/mcp reload
+```
 
-## Entry points
+The interactive status and authentication surfaces require a TUI. Resolved configuration and catalog APIs remain usable by headless hosts.
+
+## Credentials and trust
+
+Allowed stdio entries execute their configured commands with the Pi process environment and operating-system privileges. Review configuration as executable code.
+
+OAuth credentials use the operating-system keyring when available. The private-file fallback is stored under `~/.mcp-proxy/oauth` with owner-only permissions. Treat both the configuration and credential store as sensitive.
+
+## Public API
+
+```ts
+import { buildMcpConfigGroups, readCachedCatalog, registerMcpExtension, toPiToolName } from '@agimon-ai/doompi-mcp';
+import type { McpAllowlist, McpSessionConfig } from '@agimon-ai/doompi-mcp';
+```
+
+`--emit-mcp` on the DoomPi CLI can emit the resolved MCP configuration without launching a model.
+
+## Development
+
+```bash
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+```
 
-| Import                                  | Purpose               |
-| --------------------------------------- | --------------------- |
-| `@agimon-ai/doompi-mcp`                 | Library API           |
-| `@agimon-ai/doompi-mcp/extensions/pi`   | Standalone Pi adapter |
-| `@agimon-ai/doompi-mcp/extensions/doom` | Doompi adapter        |
+Maintained by [Agimon](https://agimon.ai/about).
 
 ## License
 

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@agimon-ai/doompi-mcp",
-  "version": "0.0.1-alpha.21",
-  "description": "MCP server tools for Doompi",
+  "version": "0.0.1-alpha.23",
+  "description": "Domain-aware MCP server selection and access boundaries for Pi sessions composed with DoomPi.",
   "keywords": [
-    "ai",
     "coding-agent",
-    "developer-tools",
     "doompi",
-    "pi-package"
+    "mcp",
+    "model-context-protocol",
+    "pi-coding-agent",
+    "pi-extension",
+    "server-selection"
   ],
   "homepage": "https://agimon.ai",
   "license": "MIT",
@@ -47,9 +49,9 @@
     "open": "8.4.2",
     "typebox": "1.1.38",
     "yaml": "2.9.0",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.21",
-    "@agimon-ai/doompi-ui": "0.0.1-alpha.21",
-    "@agimon-ai/mcp-proxy": "0.31.11"
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.23",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.23",
+    "@agimon-ai/mcp-proxy": "0.31.13"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",