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

cli/cmd/mcp/mcp.go

@@ -0,0 +1,41 @@
+// Package mcpcmd holds the `weknora mcp` command tree.
+//
+// MCP (Model Context Protocol; https://spec.modelcontextprotocol.io/) is
+// the JSON-RPC 2.0 wire protocol agentic IDEs use to call external tools.
+// `weknora mcp serve` exposes a curated subset of the CLI as MCP tools so
+// an IDE-side agent can list / view / search / chat against the user's
+// active WeKnora profile without shelling out to the CLI per call. Most
+// tools are read-only; chat and session_ask create conversation/message
+// records.
+//
+// Package name is `mcpcmd` to avoid shadowing `cli/internal/mcp` (the
+// transport-and-handlers implementation). Same naming hygiene as
+// `agentcmd` / `sessioncmd`.
+package mcpcmd
+
+import (
+	"github.com/spf13/cobra"
+
+	"github.com/Tencent/WeKnora/cli/internal/cmdutil"
+)
+
+// NewCmd builds the `weknora mcp` parent. Called from cli/cmd/root.go.
+func NewCmd(f *cmdutil.Factory) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "mcp",
+		Short: "Run weknora as a Model Context Protocol server",
+		Long: `Exposes weknora's tool surface as MCP tools so any
+MCP-compatible client can call them over JSON-RPC.
+
+Curated 10-tool surface: kb_list / kb_view / doc_list / doc_view /
+doc_download / search_chunks / chunk_list / agent_list are read-only;
+chat and session_ask create conversation/message records. Destructive
+verbs (create / delete / upload) are deliberately excluded - the agent
+should ask the user before mutating; the CLI's exit-10 protocol covers
+that path.`,
+		Args: cobra.NoArgs,
+		Run:  func(c *cobra.Command, _ []string) { _ = c.Help() },
+	}
+	cmd.AddCommand(NewCmdServe(f))
+	return cmd
+}

cli/cmd/mcp/serve.go

@@ -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
+}