MCP Client Manager Go

MCPAI代理

提供方 VikashLoomba

AI代理 未标注 OAuth 授权 社区 / 第三方

一个轻量级的MCP客户端管理工具,用于管理多个MCP传输、分发事件并提供工具调用、提示和资源访问的便捷接口。

一句话选型结论

按资料字段整理

MCP Client Manager Go 属于AI代理类 MCP 服务器,传输方式未标注,OAuth 授权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权OAuth 授权 部署方式未标注
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

客户端管理Go本地部署工具调用资源访问事件分发轻量级

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Client Manager Go当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方VikashLoomba上游标注的维护方 VikashLoomba
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

13.4 KB
来自项目仓库与上游目录的原文,未做删改

MCP客户经理(Go)

mcpmgr 是围绕
modelcontextprotocol/go-sdk
客户。它使多个MCP传输(stdio或HTTP)保持活动状态,扇出
事件,并展示人体工程学助手,用于列出或调用工具、提示、,
以及Go应用程序中的资源。同伴 mcpgateway 包构建
在...之上 mcpmgr 通过单个Streamable公开每个托管服务器
HTTP端点。

安装```bash

go get github.com/vikashloomba/mcp-client-manager-go/pkg/mcpmgr
go get github.com/vikashloomba/mcp-client-manager-go/pkg/mcp-gateway


## 使用预先注册的服务器进行初始化```go
package main

import (
"context"
"time"

"github.com/vikashloomba/mcp-client-manager-go/pkg/mcpmgr"
)

func main() {
manager := mcpmgr.NewManager(map[string]mcpmgr.ServerConfig{
"stdio-example": &mcpmgr.StdioServerConfig{
BaseServerConfig: mcpmgr.BaseServerConfig{Timeout: 30 * time.Second},
Command:          "npx",
Args:             []string{"@modelcontextprotocol/server-everything"},
},
"streamable-example": &mcpmgr.HTTPServerConfig{
BaseServerConfig: mcpmgr.BaseServerConfig{Timeout: 30 * time.Second},
Endpoint:         "https://gitmcp.io/modelcontextprotocol/go-sdk",
},
}, &mcpmgr.ManagerOptions{DefaultClientName: "my-app", AutoConnect: true})

ctx := context.Background()
// AutoConnect will dial the transports in the background; ensure you close
// them before exiting.
defer manager.DisconnectAllServers(ctx)
}

初始化后添加服务器```go

ctx := context.Background()

config := &mcpmgr.HTTPServerConfig{
BaseServerConfig: mcpmgr.BaseServerConfig{Timeout: 45 * time.Second},
Endpoint: "https://gitmcp.io/modelcontextprotocol/go-sdk",
}

if _, err := manager.ConnectToServer(ctx, "docs-server", config); err != nil {
panic(err)
}


## 列出和调用工具```go
tools, err := manager.ListTools(ctx, "streamable-example", nil)
if err != nil {
panic(err)
}

for _, tool := range tools.Tools {
println("Tool:", tool.Name)
}

result, err := manager.ExecuteTool(ctx, "streamable-example", "fetch_url_content", map[string]any{
"url": "https://example.com",
})
if err != nil {
panic(err)
}
println("Result:", result.Content)

阅读提示和资源```go

prompts, err := manager.ListPrompts(ctx, "stdio-example", nil)
if err != nil {
panic(err)
}
for _, prompt := range prompts.Prompts {
println("Prompt:", prompt.Name)
}

resources, err := manager.ListResources(ctx, "stdio-example", nil)
if err != nil {
panic(err)
}
for _, resource := range resources.Resources {
println("Resource:", resource.URI)
}

details, err := manager.ReadResource(ctx, "stdio-example", &mcp.ReadResourceParams{URI: resources.Resources[0].URI})
if err != nil {
panic(err)
}
println("First resource size:", len(details.Resource.Data))


## 运行可流式MCP网关

这 `mcpgateway` 软件包重新导出由管理的每个工具、提示和资源
`mcpmgr` 通过单个Streamable HTTP端点,因此仅限下游客户端
必须连接一次。```go
package main

import (
"context"
"log"
"time"

mcpgateway "github.com/vikashloomba/mcp-client-manager-go/pkg/mcp-gateway"
"github.com/vikashloomba/mcp-client-manager-go/pkg/mcpmgr"
)

func main() {
manager := mcpmgr.NewManager(map[string]mcpmgr.ServerConfig{
"stdio-example": &mcpmgr.StdioServerConfig{
BaseServerConfig: mcpmgr.BaseServerConfig{Timeout: 30 * time.Second},
Command:          "npx",
Args:             []string{"@modelcontextprotocol/server-everything"},
},
}, &mcpmgr.ManagerOptions{DefaultClientName: "gateway-example", AutoConnect: true})

gateway, err := mcpgateway.NewGateway(manager, &mcpgateway.Options{Addr: ":8787", Path: "/mcp"})
if err != nil {
log.Fatalf("gateway init failed: %v", err)
}

ctx := context.Background()
defer manager.DisconnectAllServers(ctx)

log.Println("Serving MCP gateway on http://localhost:8787/mcp")
if err := gateway.ListenAndServe(ctx); err != nil {
log.Fatalf("gateway stopped: %v", err)
}
}

检查 cmd/gateway-example 对于可运行的示例和下的包文档
pkg/mcp-gateway 对于命名空间策略等定制选项,
通知挂钩、进度扇出和启发桥接。

检查并序列化服务器配置

GetServerSummaries() 返回一段摘要,其中 Config 是一个
ServerConfig 接口由实现 *StdioServerConfig 或
*HTTPServerConfig。为了避免在每个呼叫站点进行类型切换,请使用辅助程序
防护装置和窄缝器:```go
summaries := manager.GetServerSummaries()
for _, s := range summaries {
switch mcpmgr.TransportOf(s.Config) {
case mcpmgr.TransportStdio:
if cfg, ok := mcpmgr.AsStdio(s.Config); ok {
// Use cfg.Command, cfg.Args, cfg.Env, etc.
}
case mcpmgr.TransportHTTP:
if cfg, ok := mcpmgr.AsHTTP(s.Config); ok {
// Use cfg.Endpoint, cfg.MaxRetries, cfg.PreferSSE, etc.
}
}
}


注: `BaseServerConfig` 包含功能字段(例如。, `OnError`, `RPCLogger`)
哪个 `encoding/json` 不能元帅。当生成返回的API时
将摘要转换为JSON,构造一个JSON安全的DTO,而不是封送配置
直接。例如:```go
type serverSummaryDTO struct {
ID     string                 `json:"id"`
Status mcpmgr.ConnectionStatus `json:"status"`
Config map[string]any         `json:"config"`
}

func buildSummaryDTOs(m *mcpmgr.Manager) ([]serverSummaryDTO, error) {
sums := m.GetServerSummaries()
out := make([]serverSummaryDTO, 0, len(sums))
for _, s := range sums {
dto := serverSummaryDTO{ID: s.ID, Status: s.Status, Config: map[string]any{}}
switch mcpmgr.TransportOf(s.Config) {
case mcpmgr.TransportStdio:
if c, ok := mcpmgr.AsStdio(s.Config); ok {
dto.Config = map[string]any{
"type":           "stdio",
"command":        c.Command,
"args":           c.Args,
"env":            c.Env,
"timeoutSeconds": int(c.BaseServerConfig.Timeout / time.Second),
"version":        c.BaseServerConfig.Version,
}
}
case mcpmgr.TransportHTTP:
if c, ok := mcpmgr.AsHTTP(s.Config); ok {
dto.Config = map[string]any{
"type":           "http",
"endpoint":       c.Endpoint,
"maxRetries":     c.MaxRetries,
"sessionId":      c.SessionID,
"preferSse":      c.PreferSSE,
"timeoutSeconds": int(c.BaseServerConfig.Timeout / time.Second),
"version":        c.BaseServerConfig.Version,
}
}
}
out = append(out, dto)
}
return out, nil
}

添加自定义HTTP路由

如果您想在MCP网关旁边托管额外的端点(用于健康
检查、指标等),呼叫 ServeMux() 获取底层多路复用器
在启动服务器之前注册路由:```go
gateway, _ := mcpgateway.NewGateway(manager, &mcpgateway.Options{Addr: ":8787", Path: "/mcp"})

// Add custom routes on the same server.
mux := gateway.ServeMux()
mux.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) { w.WriteHeader(200) })

// Start the gateway's server.
_ = gateway.ListenAndServe(context.Background())


或者,您可以运行自己的 `http.Server` 并重用网关的
处理程序和状态:```go
srv := &http.Server{Addr: ":8787"}
// If Handler is nil, ListenAndServeServer will install gateway.Handler().
_ = gateway.ListenAndServeServer(context.Background(), srv)

当通过启用承载令牌保护时 Options.TokenVerifier,只有
可流化MCP端点由该中间件保护。其他路线您
寄存器不会自动打包;根据需要应用自己的身份验证。

UI根镜像

一些MCP服务器根据客户端的UI限制对文件资源的访问
“根”。网关可以将UI的根集镜像到每个下游服务器。
当你的UI学习到它的有效根时,使用新的助手:```go
// Replace all roots at once (diffed and propagated to all downstream servers):
gateway.SetUIRoots([]*mcp.Root{{URI: "file:///workspace", Name: "Workspace"}})

// Or incrementally add/remove roots:
gateway.AddUIRoots(&mcp.Root{URI: "file:///tmp", Name: "Temp"})
gateway.RemoveUIRoots("file:///tmp")


当通过连接新服务器时 `gateway.AttachServer`,当前缓存
根被推送到该服务器的客户端,因此它立即反映了UI集。

### 干净地删除服务器

网关现在暴露 `DetachServer` 和 `RemoveServer` 助手:```go
// Detach removes a server's tools/prompts/resources from the aggregated view.
_ = gateway.DetachServer(ctx, serverID)

// Remove detaches and then calls manager.RemoveServer to close and delete it.
_ = gateway.RemoveServer(ctx, serverID)

另外, mcpmgr.Manager 发出网关订阅的删除事件
给;打电话 manager.RemoveServer(ctx, id) 自动修剪服务器的
网关的功能,这样它们就不会再出现在客户端面前。

进度通知

两者 mcpmgr 网关保护 _meta.progressToken 价值观和前进
notifications/progress 端到端,即使上游服务器发出浮点数
令牌或客户端省略令牌(网关会自动为每个请求生成一个令牌)。
下游消费者只需在连接时注册处理程序:```go
client := mcp.NewClient(
&mcp.Implementation{Name: "ui", Version: "1.0.0"},
&mcp.ClientOptions{
ProgressNotificationHandler: func(_ context.Context, req *mcp.ProgressNotificationClientRequest) {
if req == nil || req.Params == nil {
return
}
log.Printf("progress %s %.0f/%.0f", req.Params.Message, req.Params.Progress, req.Params.Total)
},
},
)
session, err := client.Connect(ctx, transport, nil)


如果您需要观察Go服务中的上游进度(用于指标或
UI继电器),设置 `ManagerOptions.DefaultClientOptions.ProgressNotificationHandler`
或打电话 `manager.AddNotificationHandler(serverID, mcpmgr.NotificationSchemaProgress, ...)`.

### 可选OAuth 2.0保护

`mcpgateway` 在转发任何MCP流量之前,可能需要承载令牌。到
启用此功能,填充 `mcpgateway.Options.TokenVerifier` 用你的代币
检查逻辑并提供匹配 `TokenOptions`
(`auth.RequireBearerTokenOptions`).当两者都存在时,网关会封装
可流式处理程序 `auth.RequireBearerToken`,自动托管
`/.well-known/oauth-protected-resource`,回答正确
`WWW-Authenticate: Bearer resource_metadata=…` header,并在上启用CORS
元数据端点。集 `Options.AuthorizationServer` 因此,元数据响应
链接到您的发行人,并覆盖 `Options.ResourceURL` 如果公共URL
客户端将使用不匹配 `http://localhost`.

样品在 `cmd/gateway-example` 将此行为与环境切换
变量,这样您就可以在不更改代码的情况下选择加入:

|变量|描述|示例值|
| --- | --- | --- |
| `AUTHORIZATION_SERVER_URL` |发出网关令牌的OAuth 2.0/OIDC授权服务器的基本URL。 | `https://example-server.modelcontextprotocol.io/` |
| `OAUTH_RESOURCE_METADATA_URL` |客户端发现网关资源元数据的完全限定URL。这通常应该是您部署的网关 `/.well-known/oauth-protected-resource`. | `https://example-server.modelcontextprotocol.io/.well-known/oauth-protected-resource` |

`mcpgateway.Options.ResourceURL` 控制 `"resource"` 返回的值
元数据端点。它默认为 `http://localhost`,匹配
进程内监听器,因此在公共网关URL存在时明确设置它
在代理后面或使用与本地侦听器不同的TLS/主机名。

如果设置了这两个变量,则该示例将附加您的验证器并保护
可流化端点;如果其中任何一个为空,则网关仍对本地用户开放
发展。最小启动顺序如下:```bash
export AUTHORIZATION_SERVER_URL="https://example-server.modelcontextprotocol.io/"
export OAUTH_RESOURCE_METADATA_URL="https://example-server.modelcontextprotocol.io/.well-known/oauth-protected-resource"
go run ./cmd/gateway-example

样品内部 TokenVerifier,用真正的JWT替换占位符逻辑
对您的授权服务器进行检查或令牌自检调用。

MCP管理器用户界面(弃权3)

这 apps/mcp-manager-ui/ 目录包含一个Wails 3桌面项目,该项目练习管理器和网关API。使用 wails3 dev 用于实时开发或 wails3 build 生成可分发的二进制文件。

UI模块导入以下包 github.com/vikashloomba/mcp-client-manager-go/pkg/mcpmgr。因为存储库在中定义了一个工作区 go.work:```go
use (
.
./apps/mcp-manager-ui
)


Go在此签出中将这些导入解析到本地源,而不是获取已发布的模块。这使UI与后端保持相同的提交状态——不需要替换指令——因此您可以迭代 `pkg/mcpmgr`, `pkg/mcp-gateway`,同时具有腰部前端。

## 回应启发请求```go
manager.SetElicitationCallback(func(ctx context.Context, event *mcpmgr.ElicitationEvent) (*mcp.ElicitResult, error) {
println("Elicitation from", event.ServerID, "message:", event.Message)

// Option A: respond immediately.
return &mcp.ElicitResult{Content: []any{"acknowledged"}}, nil
})

// Option B: defer the response and use RespondToElicitation later.

manager.SetElicitationCallback(func(ctx context.Context, event *mcpmgr.ElicitationEvent) (*mcp.ElicitResult, error) {
go func(id string) {
manager.RespondToElicitation(id, &mcp.ElicitResult{Content: []any{"done"}})
}(event.RequestID)
return nil, nil // pending response will be delivered asynchronously.
})

下一步

  • 通过注册通知处理程序 OnToolListChanged, OnResourceUpdated,
    或 AddNotificationHandler 对服务器事件做出反应。
  • 提供自定义 RPCLogger 通过 ManagerOptions 发出JSON-RPC流量
    您的日志记录或可观察性管道。

发布

推到 main 分支通过以下方式自动剪切释放
.github/workflows/release.yml:

  • 工作流程比较 HEAD 到最近 v*.*.* 标记并碰撞
    版本(默认为补丁)。包含 #minor 或 #major 在提交消息中
    要求更大的颠簸; BREAKING CHANGE 也迫使一个重大的释放。
  • 测试成功后,跨平台 manager-example 构建二进制文件
    作为发布资产上传。然后,工作流创建标签,发布
    GitHub发布了一个更新日志,并触发了pkg.go.dev。

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
MCP Client Manager Go 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Client Manager Go 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Client Manager Go 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Client Manager Go 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

MCP Client Manager Go 能提供哪些能力?

资料显示能力标签包括 轻量级、Go、AI代理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。