MCP Go 使用教程

MCP Go 使用教程

mcp-go A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools. 项目地址: https://gitcode.com/gh_mirrors/mcp/mcp-go

1. 项目介绍

MCP Go 是一个使用 Go 语言实现的 Model Context Protocol (MCP) 的项目。MCP 是一个旨在为语言模型应用提供与外部数据源和工具无缝集成的协议。通过 MCP Go，开发者可以轻松构建支持 MCP 协议的服务器，从而允许语言模型应用通过标准化的方式访问服务器上暴露的数据和功能。

2. 项目快速启动

要开始使用 MCP Go，请按照以下步骤操作：

首先，确保你已经安装了 Go 开发环境。

然后，通过以下命令获取 MCP Go 的代码：

go get github.com/mark3labs/mcp-go

接下来，创建一个 main.go 文件，并添加以下代码来启动一个简单的 MCP 服务器：

package main

import (
	"context"
	"fmt"
	"github.com/mark3labs/mcp-go/mcp"
	"github.com/mark3labs/mcp-go/server"
)

func main() {
	// 创建 MCP 服务器
	s := server.NewMCPServer("Demo Server", "1.0.0")

	// 添加工具
	tool := mcp.NewTool("hello_world",
		mcp.WithDescription("Say hello to someone"),
		mcp.WithString("name", mcp.Required(), mcp.Description("Name of the person to greet")),
	)

	// 添加工具处理器
	s.AddTool(tool, helloHandler)

	// 启动 stdio 服务器
	if err := server.ServeStdio(s); err != nil {
		fmt.Printf("Server error: %v\n", err)
	}
}

func helloHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
	name, ok := request.Params.Arguments["name"].(string)
	if !ok {
		return nil, errors.New("name must be a string")
	}
	return mcp.NewToolResultText(fmt.Sprintf("Hello, %s!", name)), nil
}

最后，运行以下命令启动服务器：

go run main.go

服务器启动后，它将通过标准输入（stdio）监听请求。

3. 应用案例和最佳实践

以下是使用 MCP Go 的一些应用案例和最佳实践：

• 构建工具：创建工具以执行计算、数据库查询、API 调用等操作。
• 管理资源：通过资源提供静态或动态数据，例如文件内容、数据库记录等。
• 交互模式定义：使用提示定义与语言模型应用的交互模式。

例如，可以创建一个工具来执行基本算术运算：

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.WithNumber("x", mcp.Required(), mcp.Description("First number")),
	mcp.WithNumber("y", mcp.Required(), mcp.Description("Second number")),
)

// 添加计算器处理器
s.AddTool(calculatorTool, calculatorHandler)

func calculatorHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
	// 处理请求并返回结果...
}

4. 典型生态项目

MCP Go 作为一种协议实现，可以与多种生态项目配合使用。以下是一些典型的生态项目：

• 语言模型应用：集成 MCP Go 服务器，使语言模型能够访问服务器提供的数据和功能。
• 中间件：构建中间件来处理 MCP 请求，例如身份验证、日志记录、请求路由等。
• 前端界面：创建前端应用，通过 MCP Go 服务器与语言模型进行交互。

通过遵循上述指南，您可以快速上手并使用 MCP Go 项目来构建强大的集成解决方案。

mcp-go A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools. 项目地址: https://gitcode.com/gh_mirrors/mcp/mcp-go