MCP 服务器

Model Context Protocol (MCP) Implementation in Go

Golang MCP 服务器 (Golang MCP fúwùqì) This is a direct translation. "MCP" is often left untranslated as it's an acronym. However, if you need to explain what MCP stands for, you would add that explanation. For example: Golang MCP 服务器 (Golang MCP, 即 Model Configuration Protocol, 模型配置协议服务器) - Golang MCP Server (Golang MCP, which stands for Model Configuration Protocol, Model Configuration Protocol Server) The best translation depends on the context. If the audience is familiar with the acronym, the first option is sufficient. If not, the second option is better.

vishymakthal

开发者工具

访问服务器

README

Go语言实现的模型上下文协议 (MCP)

本仓库包含一个 Go 语言实现的模型上下文协议 (MCP)。MCP 是一个基于 JSON-RPC 的协议，用于 LLM 驱动的应用中客户端和服务器之间的交互。

内容

mcp/schema.go: MCP schema 的 Go 结构体定义，从 TypeScript schema 翻译而来
mcp/client.go: 用于与 MCP 服务器交互的客户端实现
examples/mcp_client_example.go: 一个展示如何使用客户端的简单示例

MCP 概述

模型上下文协议 (MCP) 实现了模型“宿主”（例如，LLM 客户端或与 LLM 交互的系统）和“服务器”（提供上下文信息、工具、提示或资源以增强 LLM 功能的系统）之间的通信。

MCP 的主要特性包括：

资源 (Resources): 宿主可以读取的文件、文档和其他数据
工具 (Tools): 宿主可以代表模型调用的函数
提示 (Prompts): 宿主可以使用的模板或预定义的消息序列
根目录 (Roots): 服务器可以操作的文件系统或数据根目录

快速开始

前提条件

Go 1.18 或更高版本

运行示例

# 设置 MCP 服务器 URL (可选，默认为 http://localhost:3000/jsonrpc)
export MCP_SERVER_URL=http://your-mcp-server/jsonrpc

# 运行示例
go run examples/mcp_client_example.go

使用 MCP 客户端

import (
    "fmt"
    
    "path/to/mcp"
)

func main() {
    // 创建一个新的客户端
    client := mcp.NewClient("http://your-mcp-server/jsonrpc")
    
    // 初始化客户端
    clientInfo := mcp.Implementation{
        Name:    "My MCP Client",
        Version: "1.0.0",
    }
    
    capabilities := mcp.ClientCapabilities{
        // 指定你的客户端支持的功能
    }
    
    err := client.Initialize(clientInfo, capabilities)
    if err != nil {
        // 处理错误
    }
    
    // 现在你可以使用各种客户端方法：
    
    // 列出资源
    resources, err := client.ListResources("")
    
    // 读取资源
    resource, err := client.ReadResource("resource-uri")
    
    // 调用工具
    result, err := client.CallTool("tool-name", map[string]interface{}{
        "argument1": "value1",
        "argument2": 123,
    })
    
    // 获取提示
    prompt, err := client.GetPrompt("prompt-name", map[string]string{
        "argName": "argValue",
    })
}