officedesk 0.0.24 → 0.0.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +32 -0
  2. package/package.json +5 -5
package/README.md CHANGED
@@ -41,6 +41,7 @@ officedesk <plugin> <command> [options]
41
41
  officedesk --help
42
42
  officedesk --list
43
43
  officedesk list-profiles
44
+ officedesk mcp-serve
44
45
  ```
45
46
 
46
47
  ### Delegate to a plugin
@@ -111,6 +112,37 @@ Print the CLI version.
111
112
  officedesk --version
112
113
  ```
113
114
 
115
+ ### `mcp-serve`
116
+
117
+ Start an MCP (Model Context Protocol) server over stdio, exposing the plugin surface as MCP tools. This is what Claude Desktop launches — no separate bridge, Python runtime, or install step is required; the server is built into the CLI binary on all platforms (macOS, Linux, Windows).
118
+
119
+ ```bash
120
+ officedesk mcp-serve
121
+ ```
122
+
123
+ Tools exposed:
124
+
125
+ | Tool | Description |
126
+ |---|---|
127
+ | `officedesk_run` | Run a CLI command: `args[0]` must be a discovered plugin (or `--version`/`--help`); anything else is refused. Returns `{ exitCode, stdout, stderr }` as JSON. Accepts an optional `timeout_seconds` (default 120). |
128
+ | `officedesk_doctor` | Report the resolved binary path, `OFFICEDESK_HOME`, CLI version, and the discovered plugin list. |
129
+
130
+ Plugins are rediscovered on every tool call, so a newly installed plugin is callable immediately — no restart or configuration change needed.
131
+
132
+ To connect Claude Desktop, add this to `claude_desktop_config.json` (Claude Desktop → Settings → Developer → Edit Config):
133
+
134
+ ```json
135
+ {
136
+ "mcpServers": {
137
+ "officedesk": {
138
+ "command": "/Users/<you>/.officedesk/bin/officedesk",
139
+ "args": ["mcp-serve"],
140
+ "env": { "OFFICEDESK_HOME": "/Users/<you>/.officedesk" }
141
+ }
142
+ }
143
+ }
144
+ ```
145
+
114
146
  ## Plugin discovery
115
147
 
116
148
  The CLI scans the following locations for `officedesk-plugin-*` executables, in order:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "officedesk",
3
- "version": "0.0.24",
3
+ "version": "0.0.26",
4
4
  "description": "Master CLI for officedesk-ai — discovers and delegates to officedesk-plugin-* executables",
5
5
  "bin": {
6
6
  "officedesk": "bin/run.js"
@@ -12,10 +12,10 @@
12
12
  "access": "public"
13
13
  },
14
14
  "optionalDependencies": {
15
- "@officedesk/linux-x64": "0.0.24",
16
- "@officedesk/win32-x64": "0.0.24",
17
- "@officedesk/darwin-x64": "0.0.24",
18
- "@officedesk/darwin-arm64": "0.0.24"
15
+ "@officedesk/linux-x64": "0.0.26",
16
+ "@officedesk/win32-x64": "0.0.26",
17
+ "@officedesk/darwin-x64": "0.0.26",
18
+ "@officedesk/darwin-arm64": "0.0.26"
19
19
  },
20
20
  "scripts": {
21
21
  "build": "tsc",