docs enforcement; safe tool names for claude desktop / fragile ahh harnesses

2026-05-19 17:18:12 +07:00
parent 5ff3216d37
commit d22f3e64c8
12 changed files with 500 additions and 23 deletions
@@ -0,0 +1,24 @@
+# wf-mcp Local MCPB
+
+This is a local-development Claude Desktop bundle for `wf-mcp`.
+
+It is intentionally not self-contained. The manifest runs:
+
+```text
+uv run --directory C:/Users/Admin/Documents/lda.chat/lda-workflow-as-struct wf-mcp --config C:/Users/Admin/Documents/lda.chat/lda-workflow-as-struct/wf_mcp.config.json serve --transport stdio --resources-as-tools --prompts-as-tools --search-tools --safe-tool-names
+```
+
+Important behavior:
+
+- `--config` points to the broker config file.
+- `store_root` is read from that config file.
+- `wf.admin.reload_config` reloads the same config file, so changing
+  `store_root` should happen in the config, not in a separate CLI override.
+- Upstream stdio tools can set their own working directory with connection
+  metadata field `cwd`.
+- `--resources-as-tools` and `--prompts-as-tools` are enabled because some
+  MCPB/Claude paths expose tools more reliably than native resources/prompts.
+- `--safe-tool-names` maps runtime MCP tool ids to Claude-safe names such as
+  `wf_workflow_list_capabilities` while payload values keep dotted names.
+
+This package assumes `uv` is available on `PATH`.
@@ -0,0 +1,65 @@
+{
+  "manifest_version": "0.3",
+  "name": "wf-mcp-local",
+  "display_name": "wf-mcp Local",
+  "version": "0.0.1",
+  "description": "Local development bundle for the wf-mcp workflow/proxy server.",
+  "long_description": "Runs the wf-mcp server from the local lda-workflow-as-struct checkout over stdio. This bundle is for local testing with Claude Desktop, not a self-contained distribution. It uses the config file in the checkout; that config owns store_root, connections, and reload behavior.",
+  "author": {
+    "name": "lda"
+  },
+  "server": {
+    "type": "binary",
+    "entry_point": "uv",
+    "mcp_config": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--directory",
+        "C:/Users/Admin/Documents/lda.chat/lda-workflow-as-struct",
+        "wf-mcp",
+        "--config",
+        "C:/Users/Admin/Documents/lda.chat/lda-workflow-as-struct/wf_mcp.config.json",
+        "serve",
+        "--transport",
+        "stdio",
+        "--resources-as-tools",
+        "--prompts-as-tools",
+        "--search-tools",
+        "--safe-tool-names"
+      ],
+      "env": {}
+    }
+  },
+  "tools": [
+    {
+      "name": "search_tools",
+      "description": "Search the wf-mcp tool catalog when search mode is enabled."
+    },
+    {
+      "name": "call_tool",
+      "description": "Call a discovered proxied tool by name when search mode is enabled."
+    },
+    {
+      "name": "wf_workflow_list_capabilities",
+      "description": "MCPB-safe preview name for runtime tool wf.workflow.list_capabilities."
+    },
+    {
+      "name": "wf_workflow_call_capability",
+      "description": "MCPB-safe preview name for runtime tool wf.workflow.call_capability."
+    }
+  ],
+  "tools_generated": true,
+  "prompts_generated": true,
+  "keywords": [
+    "mcp",
+    "workflow",
+    "proxy",
+    "local-dev"
+  ],
+  "compatibility": {
+    "platforms": [
+      "win32"
+    ]
+  }
+}