Skip to content

MCP 配置

MCP 服务配置,在主服务启动流程(core/server.go)与独立服务入口 cmd/mcp 中被消费。

yaml

yaml
# mcp configuration
mcp:
  name: GVA_MCP
  version: v1.0.0
  addr: 8889
  separate: false

struct

go
type MCP struct {
	Name            string `mapstructure:"name" json:"name" yaml:"name"`
	Version         string `mapstructure:"version" json:"version" yaml:"version"`
	Path            string `mapstructure:"path" json:"path" yaml:"path"`
	Addr            int    `mapstructure:"addr" json:"addr" yaml:"addr"`
	BaseURL         string `mapstructure:"base_url" json:"base_url" yaml:"base_url"`
	UpstreamBaseURL string `mapstructure:"upstream_base_url" json:"upstream_base_url" yaml:"upstream_base_url"`
	AuthHeader      string `mapstructure:"auth_header" json:"auth_header" yaml:"auth_header"`
	RequestTimeout  int    `mapstructure:"request_timeout" json:"request_timeout" yaml:"request_timeout"`

	// Deprecated fields kept for backward compatibility with older configs.
	SSEPath     string `mapstructure:"sse_path" json:"sse_path" yaml:"sse_path"`
	MessagePath string `mapstructure:"message_path" json:"message_path" yaml:"message_path"`
	UrlPrefix   string `mapstructure:"url_prefix" json:"url_prefix" yaml:"url_prefix"`
	Separate    bool   `mapstructure:"separate" json:"separate" yaml:"separate"`
}

description

配置名类型默认值说明
namestringGVA_MCPMCP 服务名称
versionstringv1.0.0MCP 服务版本
pathstring-MCP 服务路径
addrint8889MCP 服务端口(separate: true 时独立进程监听)
base_urlstring-MCP 服务对外基础地址
upstream_base_urlstring-上游(主服务)基础地址
auth_headerstring-向上游发起请求时携带的认证头
request_timeoutint-请求超时时间
separateboolfalse是否以独立进程方式运行 MCP 服务(已 Deprecated,仅为兼容保留)

注意事项

  • sse_pathmessage_pathurl_prefixseparate 四个字段已 Deprecated,仅为兼容旧配置保留(见结构体注释),新部署不建议使用。
  • 独立 MCP 服务入口在 cmd/mcp,使用其自带的 cmd/mcp/config.yaml