go-mcp 项目使用教程

1. 项目目录结构及介绍

go-mcp 项目是一个用于构建 MCP（Model Context Protocol）服务器的 Go 语言 SDK。以下是项目的目录结构及其简要介绍：

.
├── cmd
│   ├── mcpgen
│   │   └── main.go       # 代码生成器的主文件
│   └── temperature
│       └── main.go       # 温度转换服务器的入口文件
├── mcp.gen.go            # 代码生成器生成的 Go 文件
├── temperature.go        # 温度转换服务的实现
├── .gitignore            # Git 忽略文件
├── .goreleaser.yml       # Goreleaser 的配置文件
├── go.mod                # Go 模块定义
├── go.sum                # Go 模块校验文件
├── LICENSE               # MIT 许可证文件
└── README.md             # 项目说明文件

• cmd: 包含项目可执行命令的目录。
• cmd/mcpgen: 代码生成器的实现目录。
• cmd/temperature: 温度转换服务器的实现目录。
• mcp.gen.go: 代码生成器生成的 Go 文件，包含服务器定义和工具定义的代码。
• temperature.go: 温度转换服务的具体实现。
• .gitignore: 指定 Git 忽略的文件和目录。
• .goreleaser.yml: 配置 Goreleaser 用于发布版本。
• go.mod: 定义项目的 Go 模块依赖。
• go.sum: 校验项目依赖的完整性。
• LICENSE: 项目使用的 MIT 许可证。
• README.md: 提供项目的基本信息和使用说明。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/temperature/main.go。以下是该文件的基本内容：

package main

import (
    "context"
    "fmt"
    "log"
    "math"
    "github.com/ktr0731/go-mcp"
    "golang.org/x/exp/jsonrpc2"
)

// toolHandler 定义了处理工具请求的结构体
type toolHandler struct{}

// HandleToolConvertTemperature 处理温度转换工具的请求
func (h *toolHandler) HandleToolConvertTemperature(ctx context.Context, req *ToolConvertTemperatureRequest) (*mcp.CallToolResult, error) {
    // 实现温度转换逻辑
    // ...
}

func main() {
    // 初始化工具处理器
    handler := NewHandler(&toolHandler{})
    // 设置服务器监听和绑定器
    ctx, listener, binder := mcp.NewStdioTransport(context.Background(), handler, nil)
    // 启动 JSON-RPC 服务器
    srv, err := jsonrpc2.Serve(ctx, listener, binder)
    if err != nil {
        log.Fatalf("failed to serve: %v", err)
    }
    // 等待服务器结束
    srv.Wait()
}

该文件定义了温度转换服务器的启动逻辑，包括创建处理器、设置监听器、绑定器和启动 JSON-RPC 服务器。

3. 项目的配置文件介绍

在 go-mcp 项目中，配置文件主要是 .goreleaser.yml，它用于配置项目的版本发布流程。以下是配置文件的基本内容：

# .goreleaser.yml
builds:
  - main: ./cmd/mcpgen
  - main: ./cmd/temperature

release:
  # 设置发布信息
  name: go-mcp
  notes: "Release notes here"

这个配置文件定义了发布构建时需要包含的命令和发布时的基本信息。在发布新版本时，Goreleaser 会使用这个配置文件来构建和发布项目。