链载Ai

标题: MCP 实战：使用 Go 快速构建 MCP Server [打印本页]

---

作者: 链载Ai    时间: 昨天 17:31
标题: MCP 实战：使用 Go 快速构建 MCP Server

MCP 简介

MCP 协议（Model Context Protocol，模型上下文协议）是由 Anthropic 于 2024 年 11 月底推出的一种开放标准，旨在统一大型语言模型（LLM）与外部数据源和工具之间的通信。

• 官方地址 https://modelcontextprotocol.io
• 架构如下

MCP 协议的架构包含多个关键组件：Host（宿主程序）、MCP Client（MCP 客户端）、MCP Server（MCP 服务器）、Local Data Source（本地数据源）和 Remote Service（远程服务）。对于普通用户而言，Host 是主要关注点；而开发者则可能更关注 MCP Server。

ingFang SC", MIUI, "Hiragino Sans GB", "Microsoft YaHei", sans-serif;font-optical-sizing: inherit;font-kerning: inherit;font-feature-settings: inherit;font-variation-settings: inherit;vertical-align: baseline;display: block;margin-block-end: 1em;margin-inline: 0px;color: rgb(6, 6, 7);letter-spacing: 0.5px;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;">Host

Host 通常是与用户直接交互的桌面应用程序，例如Claude 客户端、Chatbox、Cline 等。这些应用程序内置了 MCP Client，能够通过手动配置或 Host 提供的市场安装可用的 MCP Server。

内置的 MCP Client 可以与 MCP Server 建立连接，用于后续的 RPC 通信，协议为 JSON RPC。

ingFang SC", MIUI, "Hiragino Sans GB", "Microsoft YaHei", sans-serif;font-optical-sizing: inherit;font-kerning: inherit;font-feature-settings: inherit;font-variation-settings: inherit;vertical-align: baseline;display: block;margin-block-end: 1em;margin-inline: 0px;color: rgb(6, 6, 7);letter-spacing: 0.5px;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;">MCP Server

MCP Server 主要通过 MCP 协议暴露其功能，供 Host 调用。其功能包括提示词模板构建和工具链方法调用等。MCP Server 可以提供三种主要类型的功能：

ingFang SC", MIUI, "Hiragino Sans GB", "Microsoft YaHei", sans-serif;font-optical-sizing: inherit;font-kerning: inherit;font-feature-settings: inherit;font-variation-settings: inherit;vertical-align: baseline;list-style: disc;display: block;margin-block-end: 1em;margin-inline: 0px;padding-inline-start: 40px;margin: 0.859em 0px 0px;color: rgb(6, 6, 7);letter-spacing: 0.5px;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;-webkit-text-stroke-width: 0px;white-space: normal;background-color: rgb(255, 255, 255);text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial;" class="list-paddingleft-1">

• 资源（Resources）：可以被客户端读取的类文件数据，如 API 响应或文件内容。

• 工具（Tools）：可以被 LLM 调用的函数，需要用户批准。

• 提示（Prompts）：预先编写的模板，帮助用户完成特定任务。

  
  

MCP Server 是 MCP 架构中的关键组件，它通过标准化的模型上下文协议为 AI 应用提供丰富的上下文信息和操作能力，从而增强 LLM 的实用性和灵活性

Host 安装

官方首推的 Host 是 Claude 客户端，本文主要用 Cline，所以先来安装它。

在 VSCode 搜索 Cline 安装最新版即可（我安装的是 v3.4.0），安装完成后，需要做下大模型配置，我选用的是阿里云的 deepseek-r1 满血版。

做好LLM 配置后，我们点击 Cline 顶部第二个按钮（ MCP Servers ），即可看到 Cline 内置的 MCP Server 市场，是不是感觉有点像 App Store。

当然，我们今天的目标不是测试 Cline 的市场，截图只是想让大家感受下，MCP 协议的厉害之处。

它能将整个生态分层做好，有人做好各种 Host，然后各种扩展能力或者远程服务，都可以通过 MCP Server 快速集成到你喜爱的 Host 中，统一的UI。

MCP Server 构建

官方提供了 TS，Python，Java ，kotlin SDK，你可以快速构建自己的 MCP Server，我使用的是社区 Go SDK（mark3labs/mcp-go）， 该 SDK 更新速度还可以。

本 MCP Server 主要实现当前时间的查询，支持任意时区，具体代码如下

packagemain
import( "context" "fmt" "time"  "github.com/mark3labs/mcp-go/mcp" "github.com/mark3labs/mcp-go/server")
funcmain(){ // Create MCP server  s := server.NewMCPServer(   "Demo ?",   "1.0.0",  ) // Add tool  tool := mcp.NewTool("current time",    mcp.WithDescription("Get current time with timezone, Asia/Shanghai is default"),    mcp.WithString("timezone",      mcp.Required(),      mcp.Description("current time timezone"),    ),  ) // Add tool handler  s.AddTool(tool, currentTimeHandler) // Start the stdio server iferr := server.ServeStdio(s); err !=nil{    fmt.Printf("Server error: %v\n", err)  }}
funccurrentTimeHandler(ctx context.Context, request mcp.CallToolRequest)(*mcp.CallToolResult,error) {  timezone, ok := request.Params.Arguments["timezone"].(string) if!ok {   returnmcp.NewToolResultError("timezone must be a string"),nil  }   loc, err := time.LoadLocation(timezone) iferr !=nil{   returnmcp.NewToolResultError(fmt.Sprintf("parse timezone with error: %v", err)),nil  } returnmcp.NewToolResultText(fmt.Sprintf(`current time is %s`, time.Now().In(loc))),nil}

代码解读：

• 通过mcp.NewTool定义一个叫做 “current time” 的 tool，它能接受一个叫做timezone的参数，默认值为Asia/Shanghai。
• currentTimeHandler返回对应时区的当前时间。
• server.ServeStdio表示通过标准 I/O 进行 PRC 通信。
  
  

通过 go build 生成一个叫做 mcp-go-server 的可执行程序，后面手动配置会用到。

配置 Server

按照下图，进行 MCP Server 的配置。

这里主要将我们编译的可执行程序添加到 Cline 的配置中，点击保存后它会帮我们启动一个mcp-go-server进程，并通过 MCP 协议发现我们定义好的“current time” 工具。

工具使用

接下来我们看看 current time 这个工具是否好用，首先点击 Cline 上面的“+”号，创建一个任务。

告诉我北京时间

输入任务后， Cline 开始与大模型交互，发现可以调用 current time tool，并携带大模型解析出来的 timezone 参数，通过 RPC 对 tool 进行调用，tool 返回了上海当前时间（大模型觉得上海和北京是同一时区，所以用了默认值），最后再让大模型进行结果润色，整个过程如下图。

润色结果为 “当前北京时间是：2025年2月25日 22:33:58（UTC+8）”。

当我继续问它，芝加哥当前时间是多少时，它也能很快给出正确答案。

总结

到此，我们的示例已经圆满结束。通过实践可以看出，使用 MCP SDK 开发一个 MCP 服务非常便捷，且该服务能够轻松集成到任何支持 MCP 协议的客户端程序中，这大大降低了服务与应用程序之间的集成难度。

随着 MCP 生态系统的不断壮大和完善，我们有理由相信，MCP 协议在未来将展现出更加广阔的应用前景和潜力，为 AI 领域带来更多创新和可能性。

---

欢迎光临 链载Ai (https://www.lianzai.com/)

Powered by Discuz! X3.5