- 协议版本协商: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 交叉编译。
178 lines
4.2 KiB
Go
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)
|
|
}
|
|
})
|
|
}
|
|
}
|