WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

2026-09-22 16:19:06 +08:00
commit f7fc992f57
3929 changed files with 1006607 additions and 0 deletions
@@ -0,0 +1,61 @@
+package mcpcmd
+
+import (
+	"github.com/spf13/cobra"
+
+	"github.com/Tencent/WeKnora/cli/internal/cmdutil"
+	mcpserver "github.com/Tencent/WeKnora/cli/internal/mcp"
+)
+
+// NewCmdServe builds `weknora mcp serve`. Currently stdio-only; HTTP
+// (streamable / SSE) transports may be added later.
+func NewCmdServe(f *cmdutil.Factory) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "serve",
+		Short: "Run an MCP server over stdio",
+		Long: `Speaks JSON-RPC 2.0 on stdin/stdout to an MCP client. Logs go to
+stderr; the data channel is reserved for protocol traffic.
+
+Authentication is inherited from the active profile (or --profile). The
+server eagerly resolves the SDK client at startup - if no profile is
+configured, the process exits with auth.unauthenticated before any MCP
+handshake. This way an IDE-side agent sees a clear failure mode rather
+than a server that handshakes successfully then errors on every tool.
+
+To register with your MCP client, add an entry pointing at this binary
+under "mcpServers":
+
+    {
+      "mcpServers": {
+        "weknora": {
+          "command": "weknora",
+          "args": ["mcp", "serve"]
+        }
+      }
+    }
+
+Consult your MCP client's documentation for the exact config-file location.`,
+		Args: cobra.NoArgs,
+		RunE: func(c *cobra.Command, _ []string) error {
+			// Eagerly construct the SDK client. Surfaces auth /
+			// configuration problems before any MCP handshake.
+			cli, err := f.Client()
+			if err != nil {
+				return err
+			}
+			return mcpserver.RunStdio(c.Context(), cli)
+		},
+	}
+	cmdutil.SetAgentHelp(cmd, cmdutil.AgentHelp{
+		UsedFor: "run weknora as a long-lived MCP (Model Context Protocol) server over stdio for an IDE/host agent",
+		Output:  "no stdout payload (JSON-RPC 2.0 protocol traffic); logs go to stderr",
+		Examples: []string{
+			"weknora mcp serve",
+		},
+		Warnings: []string{
+			"this is a long-running stdio server, not a one-shot command — register it in your MCP client (command: weknora, args: [mcp, serve])",
+			"exits with auth.unauthenticated at startup if no profile is configured",
+		},
+	})
+	return cmd
+}