Files
multica/server/internal/daemon/execenv/cursor_mcp_test.go
Wu Changming 84dc02cd65 MUL-6034: fix(cursor): normalize MCP approval server shapes (#6776)
Cursor normalizes an MCP server config into a fixed field set and order before
hashing it into an approval key, so equivalent configs written in a different
field order produced keys Multica never matched, leaving the server unapproved.

Serialize stdio servers as {type?, command, args?, env?, cwd?} and remote
servers as {type?, url, headers?}, dropping unknown fields, and marshal without
Go's HTML escaping so the bytes match Cursor's JSON.stringify output.

Approval keys verified against cursor-agent 2026.08.04-aaa8809 and
2026.07.20-8cc9c0b via `mcp enable`; expected hashes in the tests are captured
from a real Cursor install.

Reported and fixed by @wuchangming.
2026-08-12 14:29:12 +08:00

315 lines
11 KiB
Go

package execenv
import (
"encoding/json"
"os"
"path/filepath"
"reflect"
"testing"
)
func TestCursorMcpApprovalKeyMatchesCursorAgent(t *testing.T) {
t.Parallel()
keys, err := cursorMcpApprovalKeys("/tmp/work", map[string]json.RawMessage{
"fetch": json.RawMessage(`{"command":"uvx","args":["mcp-server-fetch"]}`),
})
if err != nil {
t.Fatalf("cursorMcpApprovalKeys: %v", err)
}
want := []string{"fetch-b3a6127d3cbd8e52"}
if !reflect.DeepEqual(keys, want) {
t.Fatalf("approval keys = %v, want %v", keys, want)
}
}
func TestCursorMcpApprovalKeyMatchesCursorAgentWithReorderedStdioConfig(t *testing.T) {
t.Parallel()
keys, err := cursorMcpApprovalKeys("/tmp/work", map[string]json.RawMessage{
"fetch": json.RawMessage(`{ "args": [ "mcp-server-fetch" ], "command": "uvx", "env": { "TOKEN": "x" } }`),
})
if err != nil {
t.Fatalf("cursorMcpApprovalKeys: %v", err)
}
want := []string{"fetch-4c7232835349773b"}
if !reflect.DeepEqual(keys, want) {
t.Fatalf("approval keys = %v, want %v", keys, want)
}
}
func TestCursorMcpApprovalKeyMatchesJSONStringifyWithHTMLCharacters(t *testing.T) {
t.Parallel()
keys, err := cursorMcpApprovalKeys("/tmp/work", map[string]json.RawMessage{
"fetch": json.RawMessage(`{"command":"uvx","args":["mcp"],"env":{"URL":"https://x.test?a=1&b=2"}}`),
})
if err != nil {
t.Fatalf("cursorMcpApprovalKeys: %v", err)
}
want := []string{"fetch-37ab92a3e088d73a"}
if !reflect.DeepEqual(keys, want) {
t.Fatalf("approval keys = %v, want %v", keys, want)
}
}
func TestCursorMcpApprovalKeyMatchesCursorAgentWithStdioTypeAndCwd(t *testing.T) {
t.Parallel()
keys, err := cursorMcpApprovalKeys("/private/tmp/work", map[string]json.RawMessage{
"withtypecwd": json.RawMessage(`{"enabled":true,"cwd":"/tmp/probe","timeout":30,"args":["mcp"],"command":"uvx","type":"stdio"}`),
})
if err != nil {
t.Fatalf("cursorMcpApprovalKeys: %v", err)
}
// Captured from cursor-agent 2026.08.04-aaa8809 via mcp enable.
want := []string{"withtypecwd-ba71d2f70913528e"}
if !reflect.DeepEqual(keys, want) {
t.Fatalf("approval keys = %v, want %v", keys, want)
}
}
func TestCursorMcpApprovalKeyMatchesCursorAgentForRemoteServer(t *testing.T) {
t.Parallel()
keys, err := cursorMcpApprovalKeys("/private/tmp/work", map[string]json.RawMessage{
"remote": json.RawMessage(`{"enabled":true,"headers":{"Authorization":"Bearer x"},"timeout":30,"url":"https://mcp.example.com","type":"http"}`),
})
if err != nil {
t.Fatalf("cursorMcpApprovalKeys: %v", err)
}
// Captured from cursor-agent 2026.08.04-aaa8809 via mcp enable.
want := []string{"remote-abc2ffe78532b37e"}
if !reflect.DeepEqual(keys, want) {
t.Fatalf("approval keys = %v, want %v", keys, want)
}
}
func TestPrepareCursorMcpConfigWritesProjectConfigAndApprovals(t *testing.T) {
t.Parallel()
envRoot := t.TempDir()
workDir := filepath.Join(envRoot, "workdir")
if err := os.MkdirAll(workDir, 0o755); err != nil {
t.Fatalf("mkdir workDir: %v", err)
}
manifest := &sidecarManifest{}
mcpConfig := json.RawMessage(`{
"mcpServers": {
"fetch": {"command":"uvx","args":["mcp-server-fetch"]},
"http": {"url":"https://mcp.example.com","type":"http"}
}
}`)
cursorDataDir, err := prepareCursorMcpConfig(envRoot, workDir, mcpConfig, "", manifest)
if err != nil {
t.Fatalf("prepareCursorMcpConfig: %v", err)
}
if cursorDataDir != filepath.Join(envRoot, "cursor-data") {
t.Fatalf("CursorDataDir = %q, want envRoot/cursor-data", cursorDataDir)
}
rawConfig, err := os.ReadFile(filepath.Join(workDir, ".cursor", "mcp.json"))
if err != nil {
t.Fatalf("read .cursor/mcp.json: %v", err)
}
var cfg cursorMcpConfigFile
if err := json.Unmarshal(rawConfig, &cfg); err != nil {
t.Fatalf("unmarshal .cursor/mcp.json: %v\n%s", err, rawConfig)
}
if len(cfg.McpServers) != 2 {
t.Fatalf("mcpServers length = %d, want 2: %s", len(cfg.McpServers), rawConfig)
}
if mode := filePerm(t, filepath.Join(workDir, ".cursor", "mcp.json")); mode != 0o600 {
t.Fatalf(".cursor/mcp.json mode = %#o, want 0600", mode)
}
projectRoot := cursorProjectRoot(workDir)
projectDataDir := filepath.Join(cursorDataDir, "projects", cursorSlugifyPath(projectRoot))
rawApprovals, err := os.ReadFile(filepath.Join(projectDataDir, "mcp-approvals.json"))
if err != nil {
t.Fatalf("read mcp-approvals.json: %v", err)
}
var approvals []string
if err := json.Unmarshal(rawApprovals, &approvals); err != nil {
t.Fatalf("unmarshal mcp-approvals.json: %v\n%s", err, rawApprovals)
}
wantApprovals, err := cursorMcpApprovalKeys(projectRoot, cfg.McpServers)
if err != nil {
t.Fatalf("expected approvals: %v", err)
}
if !reflect.DeepEqual(approvals, wantApprovals) {
t.Fatalf("approvals = %v, want %v", approvals, wantApprovals)
}
if mode := filePerm(t, filepath.Join(projectDataDir, "mcp-approvals.json")); mode != 0o600 {
t.Fatalf("mcp-approvals.json mode = %#o, want 0600", mode)
}
if _, err := os.Stat(filepath.Join(projectDataDir, cursorWorkspaceTrustedFile)); err != nil {
t.Fatalf("workspace trust file missing: %v", err)
}
if len(manifest.Files) == 0 {
t.Fatal("manifest did not record .cursor/mcp.json")
}
}
func TestPrepareCursorMcpConfigManagedEmptySet(t *testing.T) {
t.Parallel()
envRoot := t.TempDir()
workDir := filepath.Join(envRoot, "workdir")
if err := os.MkdirAll(workDir, 0o755); err != nil {
t.Fatalf("mkdir workDir: %v", err)
}
cursorDataDir, err := prepareCursorMcpConfig(envRoot, workDir, json.RawMessage(`{"mcpServers":{}}`), "", &sidecarManifest{})
if err != nil {
t.Fatalf("prepareCursorMcpConfig: %v", err)
}
if cursorDataDir == "" {
t.Fatal("managed empty mcp_config should still isolate CursorDataDir")
}
projectRoot := cursorProjectRoot(workDir)
rawApprovals, err := os.ReadFile(filepath.Join(cursorDataDir, "projects", cursorSlugifyPath(projectRoot), "mcp-approvals.json"))
if err != nil {
t.Fatalf("read mcp-approvals.json: %v", err)
}
var approvals []string
if err := json.Unmarshal(rawApprovals, &approvals); err != nil {
t.Fatalf("unmarshal approvals: %v", err)
}
if len(approvals) != 0 {
t.Fatalf("approvals length = %d, want 0: %v", len(approvals), approvals)
}
}
func TestPrepareCursorMcpConfigSeedsExplicitAuthSource(t *testing.T) {
t.Parallel()
envRoot := t.TempDir()
workDir := filepath.Join(envRoot, "workdir")
if err := os.MkdirAll(workDir, 0o755); err != nil {
t.Fatalf("mkdir workDir: %v", err)
}
sourceProjectDir := filepath.Join(envRoot, "source-project")
if err := os.MkdirAll(sourceProjectDir, 0o700); err != nil {
t.Fatalf("mkdir source project: %v", err)
}
sourceAuth := filepath.Join(sourceProjectDir, cursorMcpAuthFile)
if err := os.WriteFile(sourceAuth, []byte(`{"tokens":{"fetch":"secret"}}`), 0o600); err != nil {
t.Fatalf("write source auth: %v", err)
}
cursorDataDir, err := prepareCursorMcpConfig(envRoot, workDir, json.RawMessage(`{"mcpServers":{"fetch":{"command":"uvx","args":["mcp-server-fetch"]}}}`), sourceProjectDir, &sidecarManifest{})
if err != nil {
t.Fatalf("prepareCursorMcpConfig: %v", err)
}
projectRoot := cursorProjectRoot(workDir)
targetAuth := filepath.Join(cursorDataDir, "projects", cursorSlugifyPath(projectRoot), cursorMcpAuthFile)
data, err := os.ReadFile(targetAuth)
if err != nil {
t.Fatalf("read seeded auth: %v", err)
}
if string(data) != `{"tokens":{"fetch":"secret"}}` {
t.Fatalf("seeded auth = %s", data)
}
}
func TestPrepareCursorMcpConfigRemovesPriorAuthOnOptOut(t *testing.T) {
t.Parallel()
envRoot := t.TempDir()
workDir := filepath.Join(envRoot, "workdir")
if err := os.MkdirAll(workDir, 0o755); err != nil {
t.Fatalf("mkdir workDir: %v", err)
}
sourceProjectDir := filepath.Join(envRoot, "source-project")
if err := os.MkdirAll(sourceProjectDir, 0o700); err != nil {
t.Fatalf("mkdir source project: %v", err)
}
sourceAuth := filepath.Join(sourceProjectDir, cursorMcpAuthFile)
if err := os.WriteFile(sourceAuth, []byte(`{"tokens":{"fetch":"secret"}}`), 0o600); err != nil {
t.Fatalf("write source auth: %v", err)
}
mcpConfig := json.RawMessage(`{"mcpServers":{"fetch":{"command":"uvx","args":["mcp-server-fetch"]}}}`)
cursorDataDir, err := prepareCursorMcpConfig(envRoot, workDir, mcpConfig, sourceProjectDir, nil)
if err != nil {
t.Fatalf("prepareCursorMcpConfig with auth source: %v", err)
}
projectRoot := cursorProjectRoot(workDir)
targetAuth := filepath.Join(cursorDataDir, "projects", cursorSlugifyPath(projectRoot), cursorMcpAuthFile)
if _, err := os.Stat(targetAuth); err != nil {
t.Fatalf("seeded auth missing: %v", err)
}
cursorDataDir, err = prepareCursorMcpConfig(envRoot, workDir, mcpConfig, "", nil)
if err != nil {
t.Fatalf("prepareCursorMcpConfig without auth source: %v", err)
}
targetAuth = filepath.Join(cursorDataDir, "projects", cursorSlugifyPath(projectRoot), cursorMcpAuthFile)
if _, err := os.Stat(targetAuth); !os.IsNotExist(err) {
t.Fatalf("auth file should be removed after opt-out, stat err=%v", err)
}
}
func TestPrepareCursorMcpConfigRejectsArbitraryAuthSourceFile(t *testing.T) {
t.Parallel()
envRoot := t.TempDir()
workDir := filepath.Join(envRoot, "workdir")
if err := os.MkdirAll(workDir, 0o755); err != nil {
t.Fatalf("mkdir workDir: %v", err)
}
source := filepath.Join(envRoot, "other.json")
if err := os.WriteFile(source, []byte(`{"secret":true}`), 0o600); err != nil {
t.Fatalf("write source: %v", err)
}
_, err := prepareCursorMcpConfig(envRoot, workDir, json.RawMessage(`{"mcpServers":{}}`), source, &sidecarManifest{})
if err == nil {
t.Fatal("expected non-mcp-auth source file to fail")
}
}
func TestPrepareCursorMcpConfigNilDoesNotTakeOwnership(t *testing.T) {
t.Parallel()
envRoot := t.TempDir()
workDir := filepath.Join(envRoot, "workdir")
if err := os.MkdirAll(workDir, 0o755); err != nil {
t.Fatalf("mkdir workDir: %v", err)
}
cursorDataDir, err := prepareCursorMcpConfig(envRoot, workDir, nil, "", &sidecarManifest{})
if err != nil {
t.Fatalf("prepareCursorMcpConfig: %v", err)
}
if cursorDataDir != "" {
t.Fatalf("CursorDataDir = %q, want empty", cursorDataDir)
}
if _, err := os.Stat(filepath.Join(workDir, ".cursor", "mcp.json")); !os.IsNotExist(err) {
t.Fatalf(".cursor/mcp.json should not exist, stat err=%v", err)
}
}
func TestPrepareCursorMcpConfigRejectsMalformedConfig(t *testing.T) {
t.Parallel()
envRoot := t.TempDir()
workDir := filepath.Join(envRoot, "workdir")
if err := os.MkdirAll(workDir, 0o755); err != nil {
t.Fatalf("mkdir workDir: %v", err)
}
_, err := prepareCursorMcpConfig(envRoot, workDir, json.RawMessage(`{"mcpServers":{"bad":42}}`), "", &sidecarManifest{})
if err == nil {
t.Fatal("expected malformed server config to fail")
}
}
func filePerm(t *testing.T, path string) os.FileMode {
t.Helper()
info, err := os.Stat(path)
if err != nil {
t.Fatalf("stat %s: %v", path, err)
}
return info.Mode().Perm()
}