9bb83b47fd
`weknora mcp serve` — long-lived stdio MCP (Model Context Protocol) transport that exposes a fixed, curated tool surface to MCP-aware agents (Claude Desktop, Claude Code, custom MCP clients). Curated tool set (readonly by default): - whoami — active context + tenant - search (hybrid retrieval against a KB) - kb list / view - doc list / view - agent list / view / invoke - session list / view The list is intentionally narrow to the read + agent-invoke surface; destructive verbs (`delete` / `empty` / `upload`) are gated behind `--write`. Schema is built from each leaf cobra command's flags so adding a new tool is a single registry entry plus a Service interface. Includes the simplify post-review polish + a second simplify pass to fold the resulting feedback (typed schemas, agent_help wording, unify chat / agent invoke option names).
60 lines
2.0 KiB
Go
60 lines
2.0 KiB
Go
// Package mcp wires the curated weknora tool set to an
|
|
// modelcontextprotocol/go-sdk server. RunStdio is the entry point invoked
|
|
// by `weknora mcp serve`.
|
|
//
|
|
// Design notes:
|
|
//
|
|
// - Tool surface is hand-curated rather than auto-derived from the cobra
|
|
// tree (which would expose auth/link/completion/destructive verbs that
|
|
// don't belong on an agent-callable surface).
|
|
// - Long-running tools (chat / agent_invoke) accumulate the LLM SSE
|
|
// stream server-side and return a single CallToolResult — MCP spec
|
|
// 2025-06-18 does not define streamed tool-result content, so this is
|
|
// the canonical pattern (see Anthropic reference `everything` server
|
|
// and Stripe @stripe/mcp).
|
|
// - Handlers receive ctx for cancellation; mid-LLM-stream cancellation
|
|
// propagates to the SDK via context, which closes the SSE connection.
|
|
package mcp
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
|
|
mcpsdk "github.com/modelcontextprotocol/go-sdk/mcp"
|
|
|
|
"github.com/Tencent/WeKnora/cli/internal/build"
|
|
)
|
|
|
|
// ServiceClient bundles the SDK methods the tool registry needs. *sdk.Client
|
|
// satisfies it; tests substitute a fake to exercise the tool handlers
|
|
// in-process without standing up a real WeKnora server.
|
|
//
|
|
// Embedding the full SDK Client would couple every tool test to every SDK
|
|
// method; declaring the narrow surface here keeps the seam tight.
|
|
type ServiceClient interface {
|
|
knowledgeBaseService
|
|
knowledgeService
|
|
chatService
|
|
agentService
|
|
}
|
|
|
|
// RunStdio constructs the MCP server, registers the curated 9 tools, and
|
|
// blocks reading JSON-RPC from stdin until the client disconnects or ctx
|
|
// is cancelled. Returns the underlying transport error (if any); the cobra
|
|
// RunE caller maps it through the usual cmdutil exit-code path.
|
|
func RunStdio(ctx context.Context, svc ServiceClient) error {
|
|
v, _, _ := build.Info()
|
|
server := mcpsdk.NewServer(
|
|
&mcpsdk.Implementation{
|
|
Name: "weknora",
|
|
Version: v,
|
|
},
|
|
nil,
|
|
)
|
|
registerTools(server, svc)
|
|
if err := server.Run(ctx, &mcpsdk.StdioTransport{}); err != nil {
|
|
return fmt.Errorf("mcp serve: %w", err)
|
|
}
|
|
return nil
|
|
}
|