如何使用Golang开发MCP服务器：从mcp-go到mcp-k8s实践

最新推荐文章于 2025-06-23 16:31:40 发布
转载 最新推荐文章于 2025-06-23 16:31:40 发布 · 88 阅读 · 0 ·
CC 4.0 BY-SA版权
原文链接：https://silenceper.com/blog/
文章标签：

#golang #服务器 #kubernetes

如何使用Golang开发MCP服务器：从mcp-go到mcp-k8s实践

如何使用Golang开发MCP服务器：从mcp-go到mcp-k8s实践

April 19, 2025

随着大语言模型(LLM)与开发工具的深度融合，Model Control Protocol (MCP)协议正在成为AI与软件工具交互的重要桥梁。MCP允许LLM以结构化的方式调用工具，使AI能够执行具体的操作而不仅仅是生成文本。

本文将详细介绍如何使用Golang和 mcp-go 这个SDK来开发MCP服务器，并以我的开源项目 mcp-k8s 为具体案例，讲解如何构建一个与Kubernetes集群交互的MCP服务器。

MCP协议简介 Permalink for this section

MCP (Model Control Protocol)是一种协议，允许LLM与外部工具进行结构化交互。通过MCP，LLM可以：

  1. 获取可用工具及其参数列表
  2. 调用这些工具执行操作
  3. 获取操作结果并基于结果继续交互

这使得LLM能够"控制"外部系统，执行从查询数据库到操作Kubernetes资源等各种任务。

mcp-go SDK概述 Permalink for this section

mcp-go 是一个用Golang实现的MCP协议SDK，它提供了构建MCP服务器所需的核心组件：

  1. 工具注册和管理
  2. 协议消息处理
  3. 多种传输方式支持（stdio、HTTP SSE等）

使用mcp-go，我们可以快速构建自己的MCP服务器，而无需关心底层协议细节。

开发MCP服务器的基本步骤 Permalink for this section

使用mcp-go开发MCP服务器通常包括以下步骤：

  1. 设计并定义工具（Tools）
  2. 实现工具的具体功能
  3. 创建服务器并注册工具
  4. 配置并启动服务器

下面我们将详细介绍每一步。

1. 设计并定义工具 Permalink for this section

在MCP中，工具（Tool）是LLM可以调用的功能单元。每个工具需要定义：

  • 名称（Name）：工具的标识符
  • 描述（Description）：工具的功能描述
  • 参数（Parameters）：工具接受的参数及其类型
  • 处理函数（Handler）：实现工具功能的函数

以mcp-k8s中的 get_api_resources 工具为例：

// 定义工具
var getAPIResourcesTool = server.Tool{
    Name:        "get_api_resources",
    Description: "获取集群中所有支持的API资源类型",
    Parameters:  nil, // 此工具不需要参数
    Handler:     handleGetAPIResources,
}

// 实现处理函数
func handleGetAPIResources(ctx context.Context, rawParams json.RawMessage) (interface{}, error) {
    // 具体实现...
}

2. 实现工具的具体功能 Permalink for this section

工具的Handler函数实现具体的业务逻辑。在mcp-k8s中，这些函数主要与Kubernetes API交互。

例如，获取API资源列表的实现：

func handleGetAPIResources(ctx context.Context, rawParams json.RawMessage) (interface{}, error) {
    // 创建k8s discovery客户端
    discoveryClient, err := discovery.NewDiscoveryClientForConfig(kubeConfig)
    if err != nil {
        return nil, fmt.Errorf("创建discovery客户端失败: %w", err)
    }

    // 获取服务器上所有API组
    apiGroups, err := discoveryClient.ServerGroups()
    if err != nil {
        return nil, fmt.Errorf("获取API组失败: %w", err)
    }

    // 处理结果并返回
    result := processAPIGroups(apiGroups)
    return result, nil
}

3. 创建服务器并注册工具 Permalink for this section

使用mcp-go创建MCP服务器并注册工具：

func main() {
    // 创建MCP服务器
    s, err := server.NewServer(
        server.WithLogger(log.Default()),
    )
    if err != nil {
        log.Fatalf("创建服务器失败: %v", err)
    }

    // 注册工具
    s.RegisterTool(getAPIResourcesTool)
    s.RegisterTool(getResourceTool)
    s.RegisterTool(listResourcesTool)
    // ... 注册更多工具

    // 启动服务器
    if err := s.Start(); err != nil {
        log.Fatalf("启动服务器失败: %v", err)
    }
}

4. 配置并启动服务器 Permalink for this section

mcp-go支持多种传输方式，最常用的是stdio（标准输入/输出）和SSE（Server-Sent Events）。

// stdio模式（默认）
s, err := server.NewServer(
    server.WithLogger(log.Default()),
    server.WithTransport(server.TransportStdio),
)

// SSE模式
s, err := server.NewServer(
    server.WithLogger(log.Default()),
    server.WithTransport(server.TransportSSE),
    server.WithHost("localhost"),
    server.WithPort(8080),
)

mcp-k8s: 一个完整的实践案例 Permalink for this section

mcp-k8s 是一个使用mcp-go开发的、用于与Kubernetes集群交互的MCP服务器。它提供了以下工具：

  1. 资源类型查询工具

    • get_api_resources: 获取集群中所有支持的API资源类型

  2. 资源操作工具

    • get_resource: 获取特定资源的详细信息
    • list_resources: 列出某种资源类型的所有实例
    • create_resource: 创建新资源（可配置禁用）
    • update_resource: 更新现有资源（可配置禁用）
    • delete_resource: 删除资源（可配置禁用）

以下是mcp-k8s的核心实现：

目录结构 Permalink for this section

mcp-k8s/
├── cmd/
│   └── server/
│       └── main.go       # 主程序入口
├── internal/
│   ├── config/           # 配置处理
│   ├── k8s/              # Kubernetes客户端
│   └── tools/            # MCP工具实现
├── go.mod
└── go.sum

主程序入口 Permalink for this section

// cmd/server/main.go
func main() {
    // 解析命令行参数
    kubeconfig := flag.String("kubeconfig", "", "Kubernetes配置文件路径")
    enableCreate := flag.Bool("enable-create", false, "启用资源创建操作")
    enableUpdate := flag.Bool("enable-update", false, "启用资源更新操作")
    enableDelete := flag.Bool("enable-delete", false, "启用资源删除操作")
    transport := flag.String("transport", "stdio", "传输方式: stdio或sse")
    host := flag.String("host", "localhost", "SSE模式的主机名")
    port := flag.Int("port", 8080, "SSE模式的端口")
    flag.Parse()

    // 初始化Kubernetes客户端
    if err := k8s.InitClient(*kubeconfig); err != nil {
        log.Fatalf("初始化K8s客户端失败: %v", err)
    }

    // 创建MCP服务器
    serverOpts := []server.Option{
        server.WithLogger(log.Default()),
    }

    // 配置传输方式
    if *transport == "sse" {
        serverOpts = append(serverOpts,
            server.WithTransport(server.TransportSSE),
            server.WithHost(*host),
            server.WithPort(*port),
        )
    } else {
        serverOpts = append(serverOpts, server.WithTransport(server.TransportStdio))
    }

    s, err := server.NewServer(serverOpts...)
    if err != nil {
        log.Fatalf("创建服务器失败: %v", err)
    }

    // 注册工具
    tools.RegisterTools(s, &tools.Options{
        EnableCreate: *enableCreate,
        EnableUpdate: *enableUpdate,
        EnableDelete: *enableDelete,
    })

    // 启动服务器
    if err := s.Start(); err != nil {
        log.Fatalf("启动服务器失败: %v", err)
    }
}

工具实现示例 Permalink for this section

以 get_resource 工具为例：

// internal/tools/get_resource.go
var GetResourceTool = server.Tool{
    Name:        "get_resource",
    Description: "获取特定资源的详细信息",
    Parameters: []server.Parameter{
        {
            Name:        "apiVersion",
            Description: "资源的API版本",
            Type:        "string",
            Required:    true,
        },
        {
            Name:        "kind",
            Description: "资源类型",
            Type:        "string",
            Required:    true,
        },
        {
            Name:        "name",
            Description: "资源名称",
            Type:        "string",
            Required:    true,
        },
        {
            Name:        "namespace",
            Description: "资源所在的命名空间（如适用）",
            Type:        "string",
            Required:    false,
        },
    },
    Handler: handleGetResource,
}

type GetResourceParams struct {
    APIVersion string `json:"apiVersion"`
    Kind       string `json:"kind"`
    Name       string `json:"name"`
    Namespace  string `json:"namespace"`
}

func handleGetResource(ctx context.Context, rawParams json.RawMessage) (interface{}, error) {
    var params GetResourceParams
    if err := json.Unmarshal(rawParams, &params); err != nil {
        return nil, fmt.Errorf("解析参数失败: %w", err)
    }

    // 获取动态客户端
    dynamicClient, err := k8s.GetDynamicClient()
    if err != nil {
        return nil, err
    }

    // 获取资源GVR (Group Version Resource)
    gvr, namespaced, err := k8s.GetGVR(params.APIVersion, params.Kind)
    if err != nil {
        return nil, err
    }

    // 确定是命名空间级别还是集群级别的资源
    var object *unstructured.Unstructured
    if namespaced {
        // 如果是命名空间级别资源但未提供命名空间，使用默认命名空间
        namespace := params.Namespace
        if namespace == "" {
            namespace = "default"
        }
        object, err = dynamicClient.Resource(gvr).Namespace(namespace).Get(ctx, params.Name, metav1.GetOptions{})
    } else {
        object, err = dynamicClient.Resource(gvr).Get(ctx, params.Name, metav1.GetOptions{})
    }

    if err != nil {
        return nil, fmt.Errorf("获取资源失败: %w", err)
    }

    return object.Object, nil
}

注册所有工具 Permalink for this section

// internal/tools/tools.go
type Options struct {
    EnableCreate bool
    EnableUpdate bool
    EnableDelete bool
}

func RegisterTools(s *server.Server, opts *Options) {
    // 注册查询工具（始终启用）
    s.RegisterTool(GetAPIResourcesTool)
    s.RegisterTool(GetResourceTool)
    s.RegisterTool(ListResourcesTool)

    // 根据配置注册写操作工具
    if opts.EnableCreate {
        s.RegisterTool(CreateResourceTool)
    }
    if opts.EnableUpdate {
        s.RegisterTool(UpdateResourceTool)
    }
    if opts.EnableDelete {
        s.RegisterTool(DeleteResourceTool)
    }
}

使用方法 Permalink for this section

mcp-k8s支持两种通信模式：

1. Stdio模式（默认） Permalink for this section

在stdio模式下，mcp-k8s通过标准输入/输出流与客户端通信。

// MCP客户端配置
{
    "mcpServers": {
        "mcp-k8s": {
            "command": "/path/to/mcp-k8s",
            "args": [\
                "-kubeconfig", "/path/to/kubeconfig",\
                "-enable-create",\
                "-enable-delete",\
                "-enable-update"\
            ]
        }
    }
}

2. SSE模式 Permalink for this section

在SSE模式下，mcp-k8s暴露HTTP端点供MCP客户端连接。

# 运行SSE模式服务
./bin/mcp-k8s -kubeconfig=/path/to/kubeconfig -transport=sse -port=8080 -host=localhost -enable-create -enable-delete -enable-update

// MCP客户端配置
{
    "mcpServers": {
        "mcp-k8s": {
            "url": "http://localhost:8080/sse",
            "args": []
        }
    }
}
2401_86356308
关注
Dify与MCP协议实战指南：零基础打造你的AI智能体应用
Ven%的博客
05-07 684
通过本文的指导，即使是刚接触Dify和MCP的新手开发者，也能够快速上手构建自己的AI智能体应用。Dify与MCP的结合，大大降低了AI应用开发的门槛，让开发者能够专注于业务逻辑而非底层实现。随着技术的不断发展，我们期待看到更多创新的MCP工具和Dify工作流出现，共同推动AI应用生态的繁荣。现在，就让我们开始你的第一个Dify+MCP项目吧！提示：本文所有实操案例均来自真实项目经验，相关代码和配置可直接参考文中引用来源。如在实施过程中遇到问题，欢迎查阅Dify和MCP的官方社区获取更多支持。
通过 MCP 协议来管理 k8s 集群
AI360labs_atyun的博客
05-29 259
MCP 协议让模型有了一种能力，几乎可以和任务服务进行交互。，确保这两个命令在默认的搜索路径下面。服务，模型会根据你需求选择恰当的。命令需要在系统的搜索路径里面。连接认证配置位于用户目录下的。位于安装目录上面，名字是。同时，需要在你的系统安装。今天小编分析一下通过。首选需要确保系统按照。配置完成以后就可以和。
【Golang玩转MCP】-实现一个加减乘除MCP服务
最新发布
HONG的个人博客
06-23 346
目前MCP-GO官方的文档非常详细了，大家可以参考文档里面进行学习开发。我这里就不做过多的赘述了。看官方文档比任何一些教程都要靠谱。calHandler为具体实现方法【这里实现了计算的基础方法】今天我们使用golang简单实现一个加减乘除MCP服务。我们点击左边的连接就能开始调试我们的MCP服务了。可以使用 MCP Inspector 进行测试。运行成功之后会弹出一个界面。
如何使用Golang开发MCP服务器？MCP-K8S实践
学点程序
04-19 1420
使用Golang和mcp-go SDK开发MCP服务器是一个相对简单的过程。mcp-k8s项目展示了如何构建一个功能完整的MCP服务器，让LLM能够查询、创建、更新和删除Kubernetes资源，为集群管理提供了新的交互方式。mcp-go支持多种传输方式，最常用的是stdio（标准输入/输出）和SSE（Server-Sent Events）。是一个使用mcp-go开发的、用于与Kubernetes集群交互的MCP服务器。使用mcp-go，我们可以快速构建自己的MCP服务器，而无需关心底层协议细节。
【亲测免费】 mcp-golang：轻松实现Model Context Protocol的Go语言实现
gitblog_00990的博客
03-27 419
mcp-golang：轻松实现Model Context Protocol的Go语言实现 项目介绍 mcp-golang 是 Model Context Protocol（模型上下文协议）的一个非官方的 Go 语言实现。该协议旨在提供一种标准化的方式，使得不同的模型能够相互通信和协作。通过 mcp-golang，开发者可以轻松地使用 Go 语言编写 MCP 服务器和客户端，只需几行代码即可实现复杂...
通过Golang实现快速实现MCP Server
e891377的专栏
04-26 1247
通过上面这些步骤，咱们就成功实现了一个简单的MCP Server，它能完成基本的加减乘除运算。当然啦，这只是个开始，大家可以根据自己的实际需求，继续扩展这个MCP Server的功能。比如支持更复杂的数学运算，调用外部API获取更多数据，或者和数据库进行交互查询数据等等。要是在实现过程中遇到啥问题，欢迎在评论区留言，咱们一起讨论解决！
结合AI客户端玩转go MCP项目开发
qq_38937634的博客
04-23 1120
MCP 的核心目标是让 LLM 应用程序能够轻松集成外部系统，这在当前 AI 驱动的应用开发中非常重要。学习完本文章内容，您可以自己根据自己的业务逻辑部署对应的MCP服务，再结合AI客户端的MCP功能配置，实现项目自动化的功能。
如何使用golang开发mcp（model context protocol） server和client
03-12
好的，我现在需要帮助用户了解如何用Golang实现MCP协议的服务器端和客户端开发。首先，我需要回顾一下用户提供的引用内容，特别是关于MCP协议的信息。根据引用[1]，MCP是一种开放协议，用于让AI模型安全地与本地和...
mcp-gitee-AI人工智能资源
04-04
- main.go：Golang语言的主程序文件，表明该项目可能是用Go语言开发的。 - LICENSE：项目许可证文件，说明了用户使用该项目代码的权利和限制。 - Makefile：包含了项目的构建、测试、安装等指令，使得项目管理更为...
一文*看透 Dify 的 MCP 生态：从“能用”到“好用”的协作革命*
分享平时的学习心得和笔记
06-17 700
摘要：Anthropic推出的MCP协议为AI大模型提供了标准化协作框架，解决了工具集成的碎片化问题。Dify开源平台通过MCP协议打造了可视化智能体开发环境，实现低代码工具链编排。典型应用如智能客服系统可快速集成知识库、OA系统等服务，完成复杂业务流程。为确保安全，Dify提供白名单、参数校验等防护机制。未来MCP生态将向工具市场、多模态处理等方向扩展，推动AI协作标准化发展。（149字）
【GitHub探索】mcp-go，MCP协议的Golang-SDK
HiKariのTechLab
04-13 642
近期大模型Agent应用开发方面，MCP的概念比较流行，基于MCP的ToolServer能力开发也逐渐成为主流趋势，所以看一下mcp-go这个MCP的SDK实现。对于企业内部而言，在这个SDK基础上做封装，基本上就能够完善MCP-Server的开发生态。因此今天就简单看一下这个SDK里面，实现了什么东西。里面包括Client连接的实现、Server端的实现以及一些应用案例。
如何用golang实现一个MCP Server
Q2024107的博客
03-16 1378
MCP（Model Communication Protocol）是一种用于大语言模型（LLM）与外部工具进行交互的协议。它允许大语言模型在处理用户请求时，调用外部工具（如计算器、API、数据库等）来完成特定任务。通过 MCP，大语言模型可以扩展其功能，而无需自己实现所有逻辑。MCP 的核心思想是将复杂任务分解为多个工具调用，从而提高模型的灵活性和效率。通过上述步骤，我们成功实现了一个简单的 MCP Server，它支持加、减、乘、除等基本运算。
MCP：让 AI 工具互联互通的“普通话“
weixin_46825193的博客
03-24 807
虽然不用 MCP，通过自定义 Agent 也能实现类似功能，但 MCP 就像是"车同轨，书同文"一样，统一了工具的使用方式，大大降低了接入成本，提高了复用性。在 AI 工具的世界里，MCP 就像是这样一个"普通话"标准，让不同的 AI 工具能够无障碍沟通。，Anthropic 公司开源了 MCP（Model Context Protocol），为应用程序与 AI 大模型之间提供了统一的交互标准，使开发者能够以一致的方式将各类数据源、工具和功能连接到 AI 模型。MCP 一经推出，立刻获得了广泛支持。
使用 Go 构建 MCP Server
黑光技术
03-22 2524
比如复杂的 k8s 集群运维，复杂大规模的数据分析。MCP 可以被理解为 AI 大模型的"万能接口"，类似于 USB-C 接口在硬件领域的作用，它提供了一种标准化的方法，使 AI 模型能够与不同的数据源和工具进行无缝交互。这里输入“当前东京的时间是多少”，执行过程如下，就会在大模型解析之后去调用我们的工具进行执行获取结果，并且会对工具返回的结果使用大模型进行再次组织。天气接口使用的是腾讯云的接口，大家可以直接使用免费额度，代码也是直接从腾讯云 api 的介绍中拷贝过来的，这里做了简单的封装调用。
golang实现MCP Server核心概念
e891377的专栏
04-27 530
模型上下文协议（MCP）的Go实现，实现了LLM应用程序与外部数据源和工具之间的无缝集成。
一文弄懂用Go实现MCP服务
王中阳讲编程
04-10 2862
最近这段时间，AI领域里有一个非常热门的概念——MCP（模型上下文协议）。Anthropic推出的这一开放标准旨在为大型语言模型和AI助手提供统一的接口，使其能够轻松操作外部工具并完成更复杂的任务。本文将带你速览MCP的核心概念，并以Go语言为例，介绍如何开发MCP服务端和客户端。在过去，如果想要让AI处理特定的数据，通常只能依赖于预训练数据或者手动上传数据，这既麻烦又低效。即便对于强大的AI模型而言，也存在数据隔离的问题，无法直接访问新的数据源，每次更新数据都需要重新训练或上传。现在，MCP解决了这个问题
关于 MCP（Model Context Protocol）的综合解析
我是赛博AI Lewis
03-18 954
MCP 通过标准化上下文协议和 "深度工具链集成"，显著提升了 AI 编程工具的实用性和效率。对于开发者而言，合理利用 MCP 可实现从设计到部署的全流程自动化，但需权衡其配置成本与功能需求。未来随着模型升级（如 Claude 3.7 支持 12 万 Token 上下文窗口），MCP 在复杂项目中的应用潜力将进一步释放。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值