feat: add Tenki Cloud compute provider

.agent/mer-vin-praisonai-mcp.html

@@ -0,0 +1,330 @@
+<!-- wp:paragraph -->
+<p>praisonai-mcp is Tier 2e — the heavy MCP server host: full <code>MCPServer</code>, tool/resource/prompt registries, recipe bridge, HTTP-stream auth, and MCP client config management. Depends only on <code>praisonaiagents</code>. v0.0.2. Protocol: MCP 2025-11-25.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:merpress/mermaidjs {"align":"full"} -->
+<div class="wp-block-merpress-mermaidjs diagram-source-mermaid alignfull"><pre class="mermaid">%%{init: {"theme": "base", "themeVariables": {"background": "transparent", "lineColor": "#000000"}}}%%
+flowchart TB
+  CLIENT[Cursor Claude Desktop]
+  subgraph T1 [praisonaiagents]
+    SDK[MCP client ToolsMCPServer]
+    SEC[mcp_security shared]
+  end
+  subgraph T2e [praisonai-mcp]
+    HOST[MCPServer]
+    REG[tool resource prompt registry]
+    TR[stdio http-stream]
+    AUTH[api-key oauth scopes]
+    CFG[mcp list add sync]
+  end
+  subgraph T2a [praisonai-code optional]
+    LIGHT[serve mcp light]
+    BRIDGE[_mcp_bridge]
+  end
+  subgraph T3 [praisonai wrapper optional]
+    CAP[capabilities recipe]
+  end
+  CLIENT --> TR
+  TR --> HOST
+  HOST --> REG
+  REG -.->|adapters| CAP
+  CFG -.->|_code_bridge| LIGHT
+  BRIDGE --> CFG
+  SDK --> LIGHT
+  SEC --> TR
+  classDef agent fill:#8B0000,color:#fff
+  classDef tool fill:#189AB4,color:#fff
+  class CLIENT agent
+  class SDK agent
+  class HOST agent
+  class REG tool
+  class TR tool
+  class AUTH tool
+  class CFG tool
+  class LIGHT tool
+  class SEC tool
+</pre></div>
+<!-- /wp:merpress/mermaidjs -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Three MCP layers (do not conflate)</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Layer</th><th>Package</th><th>Role</th><th>Entry</th></tr></thead><tbody><tr><td>Client</td><td><code>praisonaiagents/mcp/</code></td><td>Connect agents to external MCP servers; OAuth storage</td><td><code>pip install "praisonaiagents[mcp]"</code></td></tr><tr><td>Light server</td><td><code>praisonai-code</code></td><td>Config-driven basic tool hosting</td><td><code>praisonai serve mcp</code></td></tr><tr><td>Heavy host</td><td><code>praisonai-mcp</code></td><td>Full server, adapters, recipe bridge, HTTP auth</td><td><code>praisonai mcp serve</code></td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Install matrix</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Install</th><th><code>praisonai mcp</code></th><th><code>praisonai serve mcp</code></th><th><code>praisonai-mcp</code> script</th></tr></thead><tbody><tr><td><code>pip install praisonai-mcp</code></td><td>—</td><td>—</td><td>✅</td></tr><tr><td><code>pip install "praisonai-mcp[all]"</code></td><td>—</td><td>—</td><td>✅ HTTP + auth</td></tr><tr><td><code>pip install praisonai-code</code> only</td><td>hidden</td><td>✅ light</td><td>—</td></tr><tr><td><code>pip install "praisonai[mcp]"</code></td><td>✅</td><td>✅</td><td>✅</td></tr><tr><td><code>pip install praisonai</code></td><td>✅</td><td>✅</td><td>✅</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:paragraph -->
+<p>1. Standalone heavy host</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>pip install "praisonai-mcp[all]"
+export OPENAI_API_KEY=sk-...
+
+praisonai-mcp --version
+praisonai-mcp serve --transport stdio
+praisonai-mcp list-tools
+praisonai-mcp doctor</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:paragraph -->
+<p>2. Full stack (same commands via <code>praisonai mcp …</code>)</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>pip install praisonai
+# or MCP-only extra
+pip install "praisonai[mcp]"
+
+praisonai mcp serve --transport stdio
+praisonai mcp list-tools
+praisonai mcp doctor</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:paragraph -->
+<p>3. Light server only (no praisonai-mcp required)</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>pip install praisonai-code "praisonaiagents[mcp]"
+
+praisonai serve mcp --port 8080
+# Uses agents ToolsMCPServer — not the heavy MCPServer</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:separator -->
+<hr class="wp-block-separator has-alpha-channel-opacity"/>
+<!-- /wp:separator -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 1 — STDIO host (Cursor / Claude Desktop)</h2>
+<!-- /wp:heading -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code># Heavy host — full PraisonAI tool registry
+praisonai-mcp serve --transport stdio
+# or
+praisonai mcp serve --transport stdio
+
+# Generate client config
+praisonai mcp config-generate --client cursor --transport stdio
+praisonai mcp config-generate --client claude-desktop --transport stdio</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:paragraph -->
+<p>STDIO uses JSON-RPC over stdin/stdout. Logs go to stderr only — never corrupt the protocol stream.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 2 — HTTP Stream host</h2>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph -->
+<p>Streamable HTTP (MCP 2025-11-25) — not legacy standalone SSE. Requires <code>[server]</code> extra (starlette + uvicorn).</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>praisonai mcp serve \
+  --transport http-stream \
+  --host 127.0.0.1 \
+  --port 8080 \
+  --endpoint /mcp \
+  --api-key my-secret-key \
+  --response-mode batch
+
+# Endpoints: POST/GET/DELETE /mcp, plus /health</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:paragraph -->
+<p>Non-localhost binds require <code>--api-key</code> or <code>--keys-file</code>. Origin validation uses shared helpers from <code>praisonaiagents.mcp.mcp_security</code>.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 3 — Recipe → MCP bridge</h2>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph -->
+<p>Turn any PraisonAI recipe into a scoped MCP server with allow/deny lists and safe mode.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>praisonai mcp serve-recipe support-reply --transport stdio
+
+praisonai mcp validate-recipe support-reply
+praisonai mcp inspect-recipe support-reply
+
+praisonai mcp config-generate-recipe support-reply --client claude-desktop</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:paragraph -->
+<p>Default denied tools include <code>shell.exec</code>, <code>file.delete</code>, <code>eval</code>, and similar destructive operations.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 4 — MCP client config management</h2>
+<!-- /wp:heading -->
+
+<!-- wp:paragraph -->
+<p>Config subcommands (<code>list</code>, <code>add</code>, <code>remove</code>, <code>sync</code>, <code>test</code>) require <code>praisonai-code</code> via <code>_code_bridge</code>.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>praisonai mcp list
+praisonai mcp add filesystem \
+  --command npx \
+  --args "-y @modelcontextprotocol/server-filesystem ."
+
+praisonai mcp test filesystem
+praisonai mcp sync
+praisonai mcp tools
+praisonai mcp status</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 5 — Built-in registry (tools, resources, prompts)</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Type</th><th>Examples</th><th>Adapter</th></tr></thead><tbody><tr><td>Tools</td><td><code>praisonai.chat.*</code>, <code>praisonai.workflow.*</code>, agent run helpers</td><td><code>mcp_server/adapters/capabilities.py</code>, <code>cli_tools.py</code></td></tr><tr><td>Resources</td><td><code>praisonai://memory/sessions</code>, <code>praisonai://workflows</code>, <code>praisonai://agents</code></td><td><code>adapters/resources.py</code></td></tr><tr><td>Prompts</td><td><code>deep-research</code>, <code>code-review</code>, <code>workflow-auto</code></td><td><code>adapters/prompts.py</code></td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code># Inspect what the host exposes
+praisonai-mcp list-tools
+praisonai-mcp list-resources
+praisonai-mcp list-prompts
+
+# Host tool search (MCPServerCLI)
+praisonai-mcp tools search "workflow"</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 6 — Security &amp; auth</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Concern</th><th>Package</th><th>Module</th></tr></thead><tbody><tr><td>Origin validation, session IDs</td><td><code>praisonaiagents</code></td><td><code>mcp/mcp_security.py</code></td></tr><tr><td>API keys, scoped keys file</td><td><code>praisonai-mcp</code></td><td><code>mcp_server/auth/api_key.py</code></td></tr><tr><td>OAuth 2.1 + PKCE</td><td><code>praisonai-mcp</code></td><td><code>mcp_server/auth/oauth.py</code></td></tr><tr><td>OIDC discovery</td><td><code>praisonai-mcp</code></td><td><code>mcp_server/auth/oidc.py</code></td></tr><tr><td>Scope enforcement</td><td><code>praisonai-mcp</code></td><td><code>mcp_server/auth/scopes.py</code></td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code># Scoped keys file (--keys-file)
+[
+  {"key": "monitor-key", "name": "monitor", "scopes": ["tools:read", "resources:read"]},
+  {"key": "admin-key", "name": "admin", "scopes": ["*"]}
+]
+
+# Env vars
+export MCP_API_KEY=your-key
+export PRAISONAI_MCP_MAX_SESSIONS=1000</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 7 — CLI routing (lazy load)</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Registry</th><th>Commands</th><th>Gate</th></tr></thead><tbody><tr><td>MCP-resident Typer</td><td>list, add, remove, sync, test, serve, doctor</td><td><code>mcp_package_available()</code></td></tr><tr><td>MCPServerCLI host</td><td>serve, list-tools, list-resources, config-generate, tasks, auth</td><td>Direct via <code>praisonai-mcp &lt;cmd&gt;</code></td></tr><tr><td>Code-resident light</td><td><code>serve mcp</code></td><td>Always available with code + agents</td></tr><tr><td>Wrapper-resident</td><td>dashboard, schedule, langfuse</td><td><code>wrapper_package_available()</code></td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:paragraph -->
+<p>Standalone <code>praisonai-code</code> hides <code>mcp</code> from <code>--help</code> when <code>praisonai-mcp</code> is not installed. Host commands like <code>praisonai-mcp serve</code> skip the <code>mcp</code> prefix; <code>praisonai mcp serve</code> goes through the Typer group.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 8 — Python API</h2>
+<!-- /wp:heading -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>import praisonai_mcp
+from praisonai_mcp.mcp_server import MCPServer
+from praisonai_mcp.mcp_server.registry import register_tool
+from praisonai_mcp.mcp_server.adapters import register_all
+
+@register_tool("custom.greet")
+def greet(name: str) -> str:
+    """Greet a person by name."""
+    return f"Hello, {name}!"
+
+register_all()
+server = MCPServer(name="praisonai")
+server.run(transport="stdio")</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code># Recipe host
+from praisonai_mcp.mcp_server import RecipeMCPAdapter
+
+adapter = RecipeMCPAdapter("support-reply")
+adapter.load()
+adapter.to_mcp_server().run(transport="stdio")
+
+# Shim path still works
+from praisonai.mcp_server import MCPServer</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Section 9 — Standalone (no wrapper)</h2>
+<!-- /wp:heading -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>pip install praisonaiagents "praisonai-mcp[all]"
+export OPENAI_API_KEY=sk-...
+
+praisonai-mcp serve --transport stdio
+praisonai-mcp list-tools
+praisonai-mcp doctor
+praisonai-mcp --help</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:paragraph -->
+<p>Heavy MCP hosting needs only <code>praisonaiagents</code> + <code>praisonai-mcp</code>. Full capability registry (workflows, deploy, extended tools) activates when the wrapper is co-installed via <code>_wrapper_bridge</code>.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Bridges (no PyPI cycles)</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Bridge</th><th>Direction</th><th>Use</th></tr></thead><tbody><tr><td><code>_mcp_bridge</code></td><td>code → mcp</td><td>Route <code>praisonai mcp</code> into Typer group</td></tr><tr><td><code>_code_bridge</code></td><td>mcp → code</td><td>Config loader, paths, output controller</td></tr><tr><td><code>_wrapper_bridge</code></td><td>mcp → wrapper</td><td>Capabilities, recipe, deploy adapters</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Backward-compat shims</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Old path</th><th>Still works via</th></tr></thead><tbody><tr><td><code>praisonai.mcp_server.*</code></td><td><code>alias_package</code> → <code>praisonai_mcp.mcp_server</code></td></tr><tr><td><code>praisonai.cli.commands.mcp</code></td><td><code>sys.modules</code> shim → mcp Typer group</td></tr><tr><td><code>from praisonai.mcp_server import MCPServer</code></td><td>Lazy re-export through shim</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Seven-package publish order</h2>
+<!-- /wp:heading -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>praisonaiagents → praisonai-code → praisonai-bot → praisonai-train → praisonai-browser → praisonai-mcp → praisonai (wrapper)</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:paragraph -->
+<p>Wrapper pins <code>praisonai-mcp&gt;=X</code> after mcp is on PyPI. CI: <code>.github/workflows/pypi-release.yml</code>. Import gate: <code>scripts/check_c12_mcp_imports.sh</code>.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">Summary</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Item</th><th>Value</th></tr></thead><tbody><tr><td>Tier</td><td>2e</td></tr><tr><td>PyPI</td><td><code>praisonai-mcp</code> v0.0.2</td></tr><tr><td>Runtime deps</td><td><code>praisonaiagents</code>, <code>mcp</code>, rich, typer</td></tr><tr><td>HTTP extra</td><td><code>[server]</code> — starlette, uvicorn</td></tr><tr><td>Auth extra</td><td><code>[auth]</code> — httpx</td></tr><tr><td>Transports</td><td><code>stdio</code>, <code>http-stream</code></td></tr><tr><td>Light alternative</td><td><code>praisonai serve mcp</code> (code tier)</td></tr><tr><td>CLI entry</td><td><code>praisonai-mcp</code> or <code>praisonai mcp</code></td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:paragraph -->
+<p>Previous: <a href="https://mer.vin/2026/07/praisonai-train-praisonai-train-fine-tuning-agent-training-in-depth/">praisonai-train</a> · Next: praisonai wrapper</p>
+<!-- /wp:paragraph -->