Разработка MCP-сервера на Go: инструменты и ресурсы

// Учебный каркас: читаем JSON-RPC построчно из stdin, отвечаем в stdout.
// В реальном проекте берите официальный MCP Go SDK — он делает это за вас.
type rpcReq struct {
    JSONRPC string          `json:"jsonrpc"`
    ID      json.RawMessage `json:"id"`
    Method  string          `json:"method"`
    Params  json.RawMessage `json:"params"`
}

func main() {
    in := bufio.NewScanner(os.Stdin)
    in.Buffer(make([]byte, 0, 64*1024), 1<<20)
    out := json.NewEncoder(os.Stdout)

    for in.Scan() {
        var req rpcReq
        if err := json.Unmarshal(in.Bytes(), &req); err != nil {
            continue
        }
        switch req.Method {
        case "initialize":
            _ = out.Encode(result(req.ID, map[string]any{
                "protocolVersion": "2025-06-18", // сверьтесь с актуальной спекой
                "capabilities":    map[string]any{"tools": map[string]any{}},
                "serverInfo":      map[string]any{"name": "demo", "version": "0.1.0"},
            }))
        case "tools/list":
            _ = out.Encode(result(req.ID, map[string]any{"tools": toolDefs()}))
        case "tools/call":
            _ = out.Encode(result(req.ID, callTool(req.Params)))
        }
    }
    // ВАЖНО: логи — только в stderr; stdout занят протоколом.
}

func callTool(params json.RawMessage) map[string]any {
    var p struct {
        Name      string          `json:"name"`
        Arguments json.RawMessage `json:"arguments"`
    }
    _ = json.Unmarshal(params, &p)

    switch p.Name {
    case "get_weather":
        var a struct{ City string `json:"city"` }
        if err := json.Unmarshal(p.Arguments, &a); err != nil || a.City == "" {
            return textResult("ошибка: нужен непустой city", true) // isError=true
        }
        return textResult("В городе "+a.City+": +18°C, ясно", false)
    default:
        return textResult("неизвестный инструмент: "+p.Name, true)
    }
}

// content — массив блоков; для текста это {type:"text", text:"..."}.
func textResult(s string, isErr bool) map[string]any {
    return map[string]any{
        "content": []map[string]any{{"type": "text", "text": s}},
        "isError": isErr,
    }
}