Files
Cyrene_v2/internal/capability/mcp/config_test.go
T
Aska b0bd93b15c
CI / Backend (build / vet / test / cross-compile) (push) Has been cancelled
CI / Frontend (tsc + vite build) (push) Has been cancelled
feat(mcp): Top5#3 对齐 MCP Go SDK——协议版本协商 + list_changed 差量刷新 + keepalive + Streamable HTTP
- 协议版本协商:initialize 先发最高版本(2025-11-25)并声明能力集合,遇
  UnsupportedProtocolVersionError(-32022)/服务器不支持版本 → negotiateMutuallySupportedVersion
  求出双方最高共同版本降级重试(最多2次);无共同版本→ErrUnsupportedProtocolVersion。
  协商结果记 negotiatedVersion,HTTP 传输回填 Mcp-Protocol-Version 头。
- tools/list_changed 订阅:capabilities 声明 tools.listChanged:true;传输读无 id 帧路由到
  handleServerNotification;refreshPending 原子旗标合并突发 + 新 goroutine 调 onToolListChanged
  (避免 stdio lineRPC 重入自锁);Registry 真差量刷新(重新 DiscoverTools→移除消失/注册新增,
  跳过同名冲突保外来工具)。
- keepalive:WithKeepAlive(interval,failures) 起 goroutine 定时 Call(ping),连续失败≥阈值关
  session(默认3,可配);服务器不支持 ping(-32601)停 keepalive 不误关;ctx+Close 取消不泄漏。
- Streamable HTTP 传输:newTransport 支持 TransportType=http|streamable(保留 stdio/SSE 推断,
  空值走旧逻辑不破坏);Call POST+Accept json/event-stream 响应可单 JSON 或 SSE 流找匹配 id;
  Mcp-Session-Id 会话 + 独立 GET SSE 流收 server 通知;config 读 MCP_TRANSPORT。
- schema 缓存判定不做:客户端透传 map[string]any 无重复编译,SDK SchemaCache 是服务端
  按 Go 类型反射场景,客户端无对应。

go build/vet/test 全绿(count=2 无 flaky) + windows/darwin 交叉编译。
2026-09-06 17:27:14 +08:00

178 lines
4.2 KiB
Go

package mcp
import (
"reflect"
"testing"
)
func TestFromEnv_DefaultServer(t *testing.T) {
t.Parallel()
pairs := []string{
"MCP_NAME=calc",
"MCP_COMMAND=mcp-calc",
"MCP_ARGS=--stdio,--transport",
"MCP_URL=",
"MCP_ENABLED=true",
}
cfg, err := FromEnv(pairs)
if err != nil {
t.Fatalf("FromEnv: %v", err)
}
if len(cfg.Servers) != 1 {
t.Fatalf("servers = %d, want 1", len(cfg.Servers))
}
s := cfg.Servers[0]
if s.Name != "calc" || s.Command != "mcp-calc" || !s.Enabled {
t.Fatalf("server = %+v, want calc/mcp-calc/enabled", s)
}
if !reflect.DeepEqual(s.Args, []string{"--stdio", "--transport"}) {
t.Fatalf("Args = %v, want [--stdio --transport]", s.Args)
}
}
func TestFromEnv_MultipleServers(t *testing.T) {
t.Parallel()
pairs := []string{
"MCP_0_NAME=calc",
"MCP_0_COMMAND=mcp-calc",
"MCP_0_ENABLED=true",
"MCP_1_NAME=web",
"MCP_1_URL=http://localhost:9090/sse",
"MCP_1_ENABLED=false",
}
cfg, err := FromEnv(pairs)
if err != nil {
t.Fatalf("FromEnv: %v", err)
}
if len(cfg.Servers) != 2 {
t.Fatalf("servers = %d, want 2", len(cfg.Servers))
}
if cfg.Servers[1].Name != "web" || cfg.Servers[1].URL != "http://localhost:9090/sse" || cfg.Servers[1].Enabled {
t.Fatalf("server[1] = %+v, want web/url/disabled", cfg.Servers[1])
}
}
func TestFromEnv_TransportType(t *testing.T) {
t.Parallel()
pairs := []string{
"MCP_NAME=web",
"MCP_URL=http://localhost:9090/mcp",
"MCP_TRANSPORT=http",
}
cfg, err := FromEnv(pairs)
if err != nil {
t.Fatalf("FromEnv: %v", err)
}
if len(cfg.Servers) != 1 {
t.Fatalf("servers = %d, want 1", len(cfg.Servers))
}
if cfg.Servers[0].TransportType != "http" {
t.Fatalf("TransportType = %q, want http", cfg.Servers[0].TransportType)
}
}
func TestFromEnv_NoServers(t *testing.T) {
t.Parallel()
cfg, err := FromEnv([]string{"MCP_ENABLED=true"})
if err != nil {
t.Fatalf("FromEnv: %v", err)
}
if len(cfg.Servers) != 0 {
t.Fatalf("servers = %d, want 0 (ENABLED alone is not a server)", len(cfg.Servers))
}
}
func TestFromEnv_Empty(t *testing.T) {
t.Parallel()
cfg, err := FromEnv(nil)
if err != nil {
t.Fatalf("FromEnv: %v", err)
}
if len(cfg.Servers) != 0 {
t.Fatalf("servers = %d, want 0", len(cfg.Servers))
}
}
func TestFromYAML(t *testing.T) {
t.Parallel()
data := []byte(`
servers:
- name: calc
command: mcp-calc
args: [--stdio]
enabled: true
- name: web
url: http://localhost:9090/sse
`)
cfg, err := FromYAML(data)
if err != nil {
t.Fatalf("FromYAML: %v", err)
}
if len(cfg.Servers) != 2 {
t.Fatalf("servers = %d, want 2", len(cfg.Servers))
}
if cfg.Servers[0].Name != "calc" || cfg.Servers[0].Command != "mcp-calc" || !cfg.Servers[0].Enabled {
t.Fatalf("server[0] = %+v, want calc/mcp-calc/enabled", cfg.Servers[0])
}
if !reflect.DeepEqual(cfg.Servers[0].Args, []string{"--stdio"}) {
t.Fatalf("Args = %v, want [--stdio]", cfg.Servers[0].Args)
}
if cfg.Servers[1].URL != "http://localhost:9090/sse" {
t.Fatalf("server[1].URL = %q, want sse url", cfg.Servers[1].URL)
}
}
func TestFromYAML_Invalid(t *testing.T) {
t.Parallel()
if _, err := FromYAML([]byte(`servers: [`)); err == nil {
t.Fatal("FromYAML with malformed YAML succeeded, want error")
}
}
func TestSplitArgs(t *testing.T) {
t.Parallel()
tests := []struct {
in string
want []string
}{
{in: "--stdio,--transport", want: []string{"--stdio", "--transport"}},
{in: " a , b ,, c ", want: []string{"a", "b", "c"}},
{in: "", want: nil},
{in: " ", want: nil},
}
for _, tt := range tests {
tt := tt
t.Run(tt.in, func(t *testing.T) {
t.Parallel()
if got := splitArgs(tt.in); !reflect.DeepEqual(got, tt.want) {
t.Fatalf("splitArgs(%q) = %v, want %v", tt.in, got, tt.want)
}
})
}
}
func TestParseBool(t *testing.T) {
t.Parallel()
tests := []struct {
in string
def bool
want bool
}{
{in: "true", def: false, want: true},
{in: "false", def: true, want: false},
{in: "TRUE", def: false, want: true},
{in: "1", def: false, want: true},
{in: "", def: true, want: true},
{in: "garbage", def: false, want: false},
}
for _, tt := range tests {
tt := tt
t.Run(tt.in, func(t *testing.T) {
t.Parallel()
if got := parseBool(tt.in, tt.def); got != tt.want {
t.Fatalf("parseBool(%q, %v) = %v, want %v", tt.in, tt.def, got, tt.want)
}
})
}
}