如何用go搭建MCP服务

大靠山

于 2025-04-21 20:28:35 发布

阅读量630

点赞数 18

文章标签： golang microsoft 开发语言人工智能数据分析数据挖掘 embedding

本文链接：https://blog.csdn.net/m0_59235245/article/details/147401869

版权

1.什么是MCP？

MCP是“模型上下文协议（Model Context Protocol）”的简称，用一句简单通俗易懂的话描述：

是一种让 AI 模型能够无缝连接到外部工具和数据源的标准化方式。想象它就像 AI 的“万能接口”，能让 AI 像用 USB 线连接设备一样，轻松调用其他程序或服务。

2.官方MCP架构图

enter image description here

MCP Hosts: 是指 LLM 启动连接的应用程序,如 Cursor、Claude Desktop、IDE 或 AI 工具。
MCP Clients: 维护与服务器一对一连接的协议客户端。
MCP Servers: 通过标准的 Model Context Protocol 给 Client 提供特定的功能。
Local Data Sources: 本地的文件、数据库和 API。
Remote Service: 外部的文件、数据库和 API。

3.MCP原理图

顺便贴一下我用mermaid画的MCP原理图mermaid：

```mermaidsequenceDiagramautonumberactor 用户participant Client as 客户端<br>（Cursor）participant LLM as LLM<br>（Claude-3.7）participant MCP as MCP服务participant 远程 as 远程服务<br>（Web Api）rect rgb(255, 255, 0)	Note over Client,MCP:初始化阶段	Client->>MCP:注册并启动MCP服务	MCP-->>Client:服务注册成功endrect rgb(255, 255, 0)	Note over 用户,远程:交互流程	用户->>Client:输入内容	Client->>LLM:将用户输入的内容提交给LLM	Note over LLM:分析用户内容，<br>并决定是否需要<br>调用MCP	LLM-->>LLM: 	rect rgb(155, 255, 155)		alt 需要调用MCP				LLM->>Client:请求客户端调用特定MCP工具				Client->>MCP:调用MCP服务，执行特定动作				MCP->>远程:调用远程Api服务				远程-->>MCP:返回远程结果				MCP-->>Client:返回结果给客户端				Client->>LLM:将MCP返回结果或动作作为上下文再次请求LLM			else 不需要调用MCP				Note over LLM:直接返回大模型输出结果		end	end	LLM-->>Client:输出内容给客户端	Client-->>用户:显示回答内容end```

4.编译go MCP服务

go version：go1.24.1
mcp-go库地址：github.com/mark3labs/mcp-go
操作步骤： 下面是一个go MCP服务的demo，可以根据自己的需要添加或更改Tool，下面是详细操作步骤：

步骤1：创建项目和main.go Choose here javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

mkdir mcp-server
cd mcp-server
vim main.go
#在main.go中添加如下内容

Choose here javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

package main

import (
    "context"
    "errors"
    "fmt"

    "github.com/mark3labs/mcp-go/mcp"
    "github.com/mark3labs/mcp-go/server"
)

func main() {
    // Create a new MCP server
    s := server.NewMCPServer(
        "Calculator Demo",
        "1.0.0",
        server.WithResourceCapabilities(true, true),
        server.WithLogging(),
        server.WithRecovery(),
    )

    // Add a calculator tool
    calculatorTool := mcp.NewTool("calculate",
        mcp.WithDescription("Perform basic arithmetic operations"),
        mcp.WithString("operation",
            mcp.Required(),
            mcp.Description("The operation to perform (add, subtract, multiply, divide)"),
            mcp.Enum("add", "subtract", "multiply", "divide"),
        ),
        mcp.WithNumber("x",
            mcp.Required(),
            mcp.Description("First number"),
        ),
        mcp.WithNumber("y",
            mcp.Required(),
            mcp.Description("Second number"),
        ),
    )

    // Add the calculator handler
    s.AddTool(calculatorTool, func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
        op := request.Params.Arguments["operation"].(string)
        x := request.Params.Arguments["x"].(float64)
        y := request.Params.Arguments["y"].(float64)

        var result float64
        switch op {
        case "add":
            result = x + y
        case "subtract":
            result = x - y
        case "multiply":
            result = x * y
        case "divide":
            if y == 0 {
                return nil, errors.New("Cannot divide by zero")
            }
            result = x / y
        }

        return mcp.NewToolResultText(fmt.Sprintf("%.2f", result)), nil
    })

    // Start the server
    if err := server.ServeStdio(s); err != nil {
        fmt.Printf("Server error: %v\n", err)
    }
}

步骤2：编译 Choose here javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

#初始化依赖包
go mod init
#加载依赖包
go mod tidy
#编译
go build -o mcpServer main.go
#查看目录文件
ls -l
#查看文件路径path
pwd
#如下：

enter image description here

步骤3：在Cursor中配置MCP命令

Command + Shift + J 打开Cursor配置命令，如下图所示，在json配置中添加如下内容：
enter image description here Choose here javascripttypescripthtmlcssshellpythongolangjavacc++c#phprubyswiftkotlinscalarustdartelixirhaskellluaperlrsql

{
  "mcpServers": {
    "calculate": {
      "command": "/Users/xxx（你的项目路径）/src/mcp-service/mcpServer"
    }
  }
}

其中 calculate 表示的是本地MCP工具的名称，command是需要执行的命令路径。

5.在Cursor中调用MCP服务

使用MCP calculate工具，若 x = 120，y = 30 ，x + y 、x * y 、x /y 分别等于多少？

enter image description here

如何学习大模型 AI ？

由于新岗位的生产效率，要优于被取代岗位的生产效率，所以实际上整个社会的生产效率是提升的。

但是具体到个人，只能说是：

“最先掌握AI的人，将会比较晚掌握AI的人有竞争优势”。

这句话，放在计算机、互联网、移动互联网的开局时期，都是一样的道理。

我在一线互联网企业工作十余年里，指导过不少同行后辈。帮助很多人得到了学习和成长。

我意识到有很多经验和知识值得分享给大家，也可以通过我们的能力和经验解答大家在人工智能学习中的很多困惑，所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限，很多互联网行业朋友无法获得正确的资料得到学习提升，故此将并将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

在这里插入图片描述